共用方式為


IHostMemoryManager::VirtualFree 方法

更新:2007 年 11 月

當做對應之 Win32 函式的邏輯包裝函式。在呼叫端處理序的虛擬位址空間中,VirtualFree 的 Win32 實作會釋放或取消認可 (或兩者都執行) 分頁區域。

HRESULT VirtualFree (
    [in] LPVOID  lpAddress,
    [in] SIZE_T  dwSize,
    [in] DWORD   dwFreeType
);

參數

  • lpAddress
    [in] 指標,指向要釋放的虛擬記憶體分頁的基底位址。

  • dwSize
    [in] 要釋放的區域大小 (以位元組計)。

  • dwFreeType
    [in] 釋放作業的類型。

傳回值

HRESULT

說明

S_OK

VirtualFree 已成功傳回。

HOST_E_CLRNOTAVAILABLE

Common Language Runtime (CLR) 尚未載入至處理序中,或者此 CLR 目前的狀態無法執行 Managed 程式碼或成功處理呼叫。

HOST_E_TIMEOUT

呼叫已逾時。

HOST_E_NOT_OWNER

呼叫端不具備鎖定功能。

HOST_E_ABANDONED

已封鎖執行緒或 Fiber 在等候事件時,該事件已遭取消。

E_FAIL

發生未知的重大錯誤。當方法傳回 E_FAIL 時,便無法在處理序內使用 CLR。對裝載方法的後續呼叫會傳回 HOST_E_CLRNOTAVAILABLE。

HOST_E_INVALIDOPERATION

嘗試釋放未透過主應用程式配置的記憶體。

備註

VirtualFree 會透過先前對 IHostMemoryManager::VirtualAlloc 函式的呼叫,釋放與 lpAddress 參數相關聯的虛擬記憶體分頁。嘗試釋放未透過主應用程式配置的記憶體時,應該會傳回 HOST_E_INVALIDOPERATION。

這些語意與 VirtualFree 之 Win32 實作的語意相同。如需詳細資訊,請參閱 Windows 平台的說明文件。

需求

**平台:**請參閱 .NET Framework 系統需求

**標頭:**MSCorEE.idl

程式庫:包含做為 MSCorEE.dll 中的資源

**.NET Framework 版本:**3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0

請參閱

參考

IHostMemoryManager

IHostMAlloc