GlobalSize 関数 (winbase.h)

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

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

構文

SIZE_T GlobalSize(
  [in] HGLOBAL hMem
);

[in] hMem

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

関数が成功した場合、戻り値は指定されたグローバルメモリオブジェクトのサイズ (バイト単位) です。

指定したハンドルが無効な場合、またはオブジェクトが破棄された場合、戻り値は 0 です。詳細なエラー情報を得るには、GetLastError を呼び出します。

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

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

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