LocalSize 関数 (winbase.h)

指定したローカルメモリオブジェクトの現在のサイズをバイト単位で取得します。

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

構文

SIZE_T LocalSize(
  [in] HLOCAL hMem
);

[in] hMem

ローカルメモリオブジェクトへのハンドル。このハンドルは、 LocalAlloc、 LocalReAlloc、または LocalHandle 関数によって返されます。

関数が成功した場合、戻り値は、指定されたローカルメモリオブジェクトのサイズ (バイト単位) です。指定したハンドルが無効な場合、またはオブジェクトが破棄された場合、戻り値は 0 です。詳細なエラー情報を得るには、GetLastError を呼び出します。

メモリブロックのサイズは、メモリが割り当てられたときに要求されたサイズよりも大きくなる可能性があります。

指定したオブジェクトのメモリブロックが破棄されていないことを確認するには、LocalSize を呼び出す前に LocalFlags 関数を呼び出します。