localSize 函式 (winbase.h)

擷取指定本機記憶體物件的目前大小，以位元組為單位。

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

語法

SIZE_T LocalSize(
  [in] HLOCAL hMem
);

[in] hMem

本機記憶體物件的句柄。 LocalAlloc、LocalReAlloc 或 LocalHandle 函式會傳回此句柄。

如果函式成功，傳回值會是指定本機記憶體物件的大小，以位元組為單位。如果指定的句柄無效，或對象已捨棄，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

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

若要確認指定的物件的記憶體區塊尚未捨棄，請先呼叫 LocalFlags 函式，再呼叫 LocalSize。