IHostMemoryManager::VirtualFree 方法

用作相应 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 公共语言运行时 (CLR) 未加载到进程中,或 CLR 处于无法运行托管代码或无法成功处理调用的状态。
HOST_E_TIMEOUT 调用超时。
HOST_E_NOT_OWNER 调用方未持有锁。
HOST_E_ABANDONED 阻塞的线程或纤程正在等待某一事件,而该事件已被取消。
E_FAIL 发生未知的灾难性故障。 当方法返回 E_FAIL 时,进程中无法再使用 CLR。 后续调用承载方法会返回 HOST_E_CLRNOTAVAILABLE。
HOST_E_INVALIDOPERATION 尝试释放未通过主机分配的内存。

注解

VirtualFree 通过更早调用 IHostMemoryManager::VirtualAlloc 函数来释放与 lpAddress 参数关联的虚拟内存页。 尝试释放未通过主机分配的内存应返回 HOST_E_INVALIDOPERATION。

语义与 VirtualFree Win32 实现的语义相同。 有关详细信息,请参阅 Windows 平台文档。

要求

平台:请参阅系统要求

标头:MSCorEE.h

库:作为资源包含在 MSCorEE.dll 中

.NET Framework 版本:自 2.0 起可用

另请参阅