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) 尚未加载到进程中或者处于无法运行托管代码或成功处理调用的状态。

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 平台文档。

要求

**平台:**请参见 .NET Framework 系统要求

**头文件:**MSCorEE.h

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

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

请参见

参考

IHostMemoryManager 接口

IHostMalloc 接口