<Return[G]><Top>

GlobalLock

Declare Function Api_GlobalLock& Lib "kernel32" Alias "GlobalLock" (ByVal hMem&)

Declare Function GlobalLock Lib "kernel32" (ByVal hMem As Long) As Long

グローバルメモリオブジェクトをロックし、メモリブロックの最初の 1 バイトへのポインタを返す。
グローバル関数は他のメモリ管理関数より低速で、提供する機能も多くはない。そのため、新しいアプリケーションは「heap functions」( ヒープ関数)を使うべきである。しかし、DDE 関数とクリップボード関数では、依然としてグローバル関数が使われている。

パラメータ
nAtom
    [入力]取得したい文字列を保持しているグローバルアトムを指定する。
lpBuffer
    [出力]文字列を受け取るバッファへのポインタを指定する。
nSize
    [入力]バッファのサイズを TCHAR 単位で指定する。


戻り値
    関数が成功すると、バッファにコピーされた文字列の長さが TCHAR 単位で返る( 終端の NULL 文字を除く)。
    関数が失敗すると、0 が返る。拡張エラー情報を取得するには、GetLastError 関数を使う。