GlobalHandle 関数 (winbase.h)

グローバルメモリブロックへの指定されたポインターに関連付けられているハンドルを取得します。

メモグローバル関数はオーバーヘッドが大きく、他のメモリ管理機能よりも機能が少なくなります。新しいアプリケーションでは、グローバル関数を使用する必要があるとドキュメントに記載されていない限り、ヒープ関数を使用する必要があります。詳細については、「グローバル関数とローカル関数」を参照してください。

構文

HGLOBAL GlobalHandle(
  [in] LPCVOID pMem
);

[in] pMem

グローバルメモリブロックの最初のバイトへのポインター。このポインターは GlobalLock 関数によって返されます。

関数が成功した場合、戻り値は指定されたグローバルメモリオブジェクトへのハンドルです。

関数が失敗した場合は、返される値は NULL です。詳細なエラー情報を得るには、GetLastError を呼び出します。

GlobalAlloc 関数は、GMEM_MOVEABLEを使用してメモリオブジェクトを割り当てると、オブジェクトにハンドルを返します。 GlobalLock 関数は、このハンドルをメモリブロックへのポインターに変換し、GlobalHandle はポインターをハンドルに戻します。