IHostSyncManager::CreateMonitorEvent 方法

创建受监视的自动重置事件对象。

语法

HRESULT CreateMonitorEvent (  
    [in]  SIZE_T cookie,  
    [out] IHostAutoEvent **ppEvent  
);  

参数

cookie
[in] 要与事件对象关联的 Cookie。

ppEvent
[out] 指向 IHostAutoEvent 实例地址的指针;如果无法创建该事件对象,则为 NULL。

返回值

HRESULT 说明
S_OK 已成功返回 CreateMonitorEvent
HOST_E_CLRNOTAVAILABLE 公共语言运行时 (CLR) 未加载到进程中,或 CLR 处于无法运行托管代码或无法成功处理调用的状态。
HOST_E_TIMEOUT 调用超时。
HOST_E_NOT_OWNER 调用方未持有锁。
HOST_E_ABANDONED 阻塞的线程或纤程正在等待某一事件,而该事件已被取消。
E_FAIL 发生未知的灾难性故障。 当方法返回 E_FAIL 时,进程中无法再使用 CLR。 后续调用承载方法会返回 HOST_E_CLRNOTAVAILABLE。
E_OUTOFMEMORY 内存不足,无法创建请求的事件对象。

注解

CLR 会使用 CreateMonitorEvent 返回的 IHostAutoEvent 实现托管的 System.Threading.Monitor 类型。 此方法使用为 bManualReset 参数指定的 false 值镜像 Win32 CreateEvent 函数。

主机通过调用 ICLRSyncManager::GetMonitorOwner 方法,可以使用此 Cookie 来确定监视器上正在等待的任务。

要求

平台:请参阅系统要求

标头:MSCorEE.h

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

.NET Framework 版本:自 2.0 起可用

请参阅