LocalFlags

指定したローカルメモリオブジェクトに関する情報を取得する。

LocalFlags hMem

hMem : [int] ローカルメモリオブジェクトのハンドル。このハンドルは LocalAlloc または LocalReAlloc 関数によって返される。

(プラグイン / モジュール : kernel32.dll)

解説

指定したローカルメモリオブジェクトに関する情報を取得する。

[戻り値]
関数が成功した場合、戻り値はメモリオブジェクトの確保属性とロックカウントを示す。関数が失敗した場合、戻り値は
LMEM_INVALID_HANDLE であり、ローカルハンドルが無効であることを示す。拡張エラー情報を取得するには
GetLastError を呼ぶ。

[備考]
戻り値の下位ワードの下位バイトにはオブジェクトのロックカウントが格納される。戻り値からロックカウントを取り出すには、ビット単位 AND
(&) 演算子と LMEM_LOCKCOUNT マスクを使う。LMEM_FIXED で確保されたメモリオブジェクトのロックカウントは常に
0 である。戻り値の下位ワードの上位バイトはメモリオブジェクトの確保属性を示し、0 または LMEM_DISCARDABLE
になり得る。ローカル関数は他のメモリ管理関数よりもオーバーヘッドが大きく、機能も少ない。新しいアプリケーションは、ドキュメントでローカル関数を使うよう指示されていない限り、ヒープ関数を使うべきである。詳細は「グローバルおよびローカル関数」を参照。

情報