共用方式為


LocalFree 函式 (winbase.h)

釋放指定的本機記憶體物件,並使它的控制碼失效。

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

語法

HLOCAL LocalFree(
  [in] _Frees_ptr_opt_ HLOCAL hMem
);

參數

[in] hMem

本機記憶體物件的控制碼。 LocalAllocLocalReAlloc函式會傳回此控制碼。 使用 GlobalAlloc配置記憶體並不安全。

傳回值

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

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

備註

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

如果 hMem 參數為 NullLocalFree 會忽略 參數並傳回 Null

LocalFree函式會釋放鎖定的記憶體物件。 鎖定的記憶體物件具有大於零的鎖定計數。 LocalLock函式會鎖定本機記憶體物件,並將鎖定計數遞增一個。 LocalUnlock函式會解除鎖定,並將鎖定計數遞減一。 若要取得本機記憶體物件的鎖定計數,請使用 LocalFlags 函式

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

範例

如需範例,請參閱 LocalAlloc

規格需求

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

另請參閱

全域和區域函式

GlobalFree

LocalAlloc

LocalFlags

LocalLock

LocalReAlloc

LocalUnlock

記憶體管理功能