GlobalFlags

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

GlobalFlags hMem

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

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

解説

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

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

[備考]
戻り値の下位ワードの下位バイトはオブジェクトのロックカウントを含む。戻り値からロックカウントを取得するには、GMEM_LOCKCOUNT
マスクをビット単位 AND (&) 演算子で使用する。GMEM_FIXED で確保されたメモリオブジェクトのロックカウントは常に 0
である。戻り値の下位ワードの上位バイトはメモリオブジェクトの確保値を示す。これは 0 または GMEM_DISCARDED
にできる。グローバル関数は他のメモリ管理関数より大きなオーバーヘッドを持ち、機能が少ない。新しいアプリケーションは、ドキュメントでグローバル関数を使用すべきと記載されていない限り、ヒープ関数を使用すべきである。詳細は
Global and Local Functions を参照。

情報