LocalHandle 関数 (winbase.h)

  • [アーティクル]

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

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

構文

HLOCAL LocalHandle(
  [in] LPCVOID pMem
);

パラメーター

[in] pMem

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

戻り値

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

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

解説

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

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー winbase.h (Windows.h を含む)
Library Kernel32.lib
[DLL] Kernel32.dll

関連項目

グローバル関数とローカル関数

LocalAlloc

LocalLock

メモリ管理関数