IHostMemoryManager::RegisterMemoryNotificationCallback 方法

更新：2007 年 11 月

注册一个指向某回调函数的指针，宿主通过调用该回调函数将计算机上当前的内存加载情况通知给公共语言运行库 (CLR)。

HRESULT RegisterMemoryNotificationCallback (
    [in] ICLRMemoryNotificationCallback* pCallback
);

参数

pCallback
[in] 一个接口指针，该指针指向由 CLR 所实现的 ICLRMemoryNotificationCallback 实例。

返回值

HRESULT	说明
S_OK	RegisterMemoryNotificationCallback 成功返回。
HOST_E_CLRNOTAVAILABLE	CLR 尚未加载到进程中或者处于无法运行托管代码或成功处理调用的状态。
HOST_E_TIMEOUT	调用超时。
HOST_E_NOT_OWNER	调用方不拥有锁。
HOST_E_ABANDONED	事件在被阻止的线程或纤程正在等待它时被取消。
E_FAIL	发生了未知的灾难性故障。如果某方法返回 E_FAIL，CLR 便无法再在进程中使用。对宿主方法的后续调用都将返回 HOST_E_CLRNOTAVAILABLE。

备注

由于 ICLRMemoryNotificationCallback 接口只定义一个方法 (ICLRMemoryNotificationCallback::OnMemoryNotification)，并且 pCallback 是指向 CLR 提供的 ICLRMemoryNotificationCallback 实例的指针，因此对该回调函数本身而言，该注册是有效的。宿主调用 OnMemoryNotification 以报告内存压力情况，而不是使用标准的 Win32 CreateMemoryResourceNotification 函数。有关更多信息，请参见 Windows 平台文档。