GlobalReAlloc 函式 (winbase.h)

變更指定之全域記憶體物件的大小或屬性。大小可能會增加或減少。

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

語法

DECLSPEC_ALLOCATOR HGLOBAL GlobalReAlloc(
  [in] _Frees_ptr_ HGLOBAL hMem,
  [in] SIZE_T              dwBytes,
  [in] UINT                uFlags
);

[in] hMem

要重新配置之全域記憶體物件的句柄。 GlobalAlloc 或 GlobalReAlloc 函式會傳回此句柄。

[in] dwBytes

記憶體區塊的新大小，以位元組為單位。如果 uFlags 指定 GMEM_MODIFY，則會忽略此參數。

[in] uFlags

重新配置選項。如果指定 GMEM_MODIFY ，則函式只會在 忽略 dwBytes 參數 (修改記憶體物件的屬性。) 否則，函式會重新配置記憶體物件。

您可以選擇性地將 GMEM_MODIFY 與下列值結合。

值	意義
GMEM_MOVEABLE 0x0002	配置可移動的記憶體。如果記憶體已鎖定 GMEM_MOVEABLE 記憶體區塊或 GMEM_FIXED 記憶體區塊，但未指定此旗標，則只能就地重新配置記憶體。

如果此參數未指定 GMEM_MODIFY，您可以使用下列值。

值	意義
GMEM_ZEROINIT 0x0040	如果記憶體物件的大小成長，會導致額外的記憶體內容初始化為零。

如果函式成功，傳回值就是重新配置記憶體物件的句柄。

如果函式失敗，傳回值為 NULL。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

如果 GlobalReAlloc 重新配置可移動的物件，則傳回值是記憶體物件的句柄。若要將句柄轉換成指標，請使用 GlobalLock 函式。

如果 GlobalReAlloc 重新配置固定對象，傳回的句柄值就是記憶體區塊之第一個字節的位址。若要存取記憶體，進程可以直接將傳回值轉換成指標。

如果 GlobalReAlloc 失敗，則不會釋放原始記憶體，而且原始句柄和指標仍然有效。

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