GlobalHandle 関数 (winbase.h)
グローバル メモリ ブロックへの指定されたポインターに関連付けられているハンドルを取得します。
メモ グローバル関数はオーバーヘッドが大きく、他のメモリ管理機能よりも機能が少なくなります。 新しいアプリケーションでは、グローバル 関数 を使用する必要があるとドキュメントに記載されていない限り、ヒープ関数を使用する必要があります。 詳細については、「 グローバル関数とローカル関数」を参照してください。
構文
HGLOBAL GlobalHandle(
[in] LPCVOID pMem
);
パラメーター
[in] pMem
グローバル メモリ ブロックの最初のバイトへのポインター。 このポインターは GlobalLock 関数によって返されます。
戻り値
関数が成功した場合、戻り値は指定されたグローバル メモリ オブジェクトへのハンドルです。
関数が失敗した場合は、返される値は NULL です。 詳細なエラー情報を得るには、GetLastError を呼び出します。
解説
GlobalAlloc 関数は、GMEM_MOVEABLEを使用してメモリ オブジェクトを割り当てると、 オブジェクトにハンドルを返します。 GlobalLock 関数は、このハンドルをメモリ ブロックへのポインターに変換し、GlobalHandle はポインターをハンドルに戻します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | winbase.h (Windows.h を含む) |
| Library | Kernel32.lib |
| [DLL] | Kernel32.dll |