指定したローカル メモリ オブジェクトの現在のサイズをバイト単位で取得します。
メモ ローカル関数はオーバーヘッドが大きく、他のメモリ管理機能よりも機能が少なくなります。 ドキュメントでローカル関数を使用する必要があると記載されていない限り、新しいアプリケーションでは ヒープ 関数を使用する必要があります。 詳細については、「 グローバル関数とローカル関数」を参照してください。
構文
SIZE_T LocalSize(
[in] HLOCAL hMem
);
パラメーター
[in] hMem
ローカル メモリ オブジェクトへのハンドル。 このハンドルは、 LocalAlloc、 LocalReAlloc、または LocalHandle 関数によって返されます。
戻り値
関数が成功した場合、戻り値は、指定されたローカル メモリ オブジェクトのサイズ (バイト単位) です。 指定したハンドルが無効な場合、またはオブジェクトが破棄された場合、戻り値は 0 です。 詳細なエラー情報を得るには、GetLastError を呼び出します。
解説
メモリ ブロックのサイズは、メモリが割り当てられたときに要求されたサイズよりも大きくなる可能性があります。
指定したオブジェクトのメモリ ブロックが破棄されていないことを確認するには、LocalSize を呼び出す前に LocalFlags 関数を呼び出します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | winbase.h (Windows.h を含む) |
| Library | Kernel32.lib |
| [DLL] | Kernel32.dll |