LocalReAlloc 函式 (winbase.h)

  • 發行項

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

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

語法

DECLSPEC_ALLOCATOR HLOCAL LocalReAlloc(
  [in] _Frees_ptr_opt_ HLOCAL hMem,
  [in] SIZE_T                 uBytes,
  [in] UINT                   uFlags
);

參數

[in] hMem

要重新配置之本機記憶體物件的控制碼。 LocalAlloc或LocalReAlloc函式會傳回此控制碼。

[in] uBytes

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

[in] uFlags

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

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

值 意義
LMEM_MOVEABLE
0x0002
 配置固定或可移動的記憶體。

如果記憶體已鎖定 LMEM_MOVEABLE 記憶體區塊或 LMEM_FIXED 記憶體區塊，但未指定此旗標，則只能就地重新配置記憶體。
 

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

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

傳回值

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

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

備註

如果 LocalReAlloc 失敗，則不會釋放原始記憶體，而且原始控制碼和指標仍然有效。

如果 LocalReAlloc 重新配置固定物件，傳回的控制碼值就是記憶體區塊之第一個位元組的位址。 若要存取記憶體，進程可以直接將傳回值轉換成指標。

規格需求

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

另請參閱

全域和區域函式

LocalAlloc

LocalFree

LocalLock

記憶體管理功能