GlobalSize 函式 (winbase.h)

擷取指定之全域記憶體物件的目前大小,以位元組為單位。

注意 全域函式具有更大的額外負荷,並提供比其他記憶體管理功能少的功能。 除非檔指出應該使用全域函式,否則新的應用程式應該使用 堆積函 式。 如需詳細資訊,請參閱 全域和本機函式
 

語法

SIZE_T GlobalSize(
  [in] HGLOBAL hMem
);

參數

[in] hMem

全域記憶體物件的句柄。 GlobalAllocGlobalReAlloc 函式會傳回此句柄。

傳回值

如果函式成功,則傳回值是以位元組為單位的指定全域記憶體物件大小。

如果指定的句柄無效,或對象已捨棄,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError

備註

記憶體區塊的大小可能大於配置記憶體時所要求的大小。

若要確認指定的物件記憶體區塊尚未捨棄,請在呼叫 GlobalSize 之前,使用 GlobalFlags 函式。

規格需求

需求
最低支援的用戶端 Windows XP [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 winbase.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

全域和區域函式

GlobalAlloc

GlobalFlags

GlobalReAlloc

記憶體管理功能