GlobalFree 函式 (winbase.h)

釋放指定的全域記憶體物件，並使控制碼失效。

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

語法

HGLOBAL GlobalFree(
  [in] _Frees_ptr_opt_ HGLOBAL hMem
);

[in] hMem

全域記憶體物件的控制碼。 GlobalAlloc或GlobalReAlloc函式會傳回此控制碼。使用 LocalAlloc配置記憶體並不安全。

如果函式成功，則傳回值為 Null。

如果函式失敗，傳回值等於全域記憶體物件的控制碼。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

如果進程在釋放記憶體之後檢查或修改記憶體，可能會發生堆積損毀，或可能會產生存取違規例外狀況 (EXCEPTION_ACCESS_VIOLATION) 。

GlobalFree函式會釋放鎖定的記憶體物件。鎖定的記憶體物件具有大於零的鎖定計數。 GlobalLock函式會鎖定全域記憶體物件，並將鎖定計數遞增一。 GlobalUnlock函式會解除鎖定，並將鎖定計數遞減一。若要取得全域記憶體物件的鎖定計數，請使用 GlobalFlags 函式。

如果應用程式是在系統的偵錯版本下執行， GlobalFree 會發出一則訊息，告知您正在釋放鎖定的物件。如果您要偵錯應用程式， GlobalFree 會在釋放鎖定的物件之前輸入中斷點。這可讓您確認預期的行為，然後繼續執行。

如需範例，請參閱 GlobalAlloc。


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