ICLRSyncManager::GetMonitorOwner 方法
获取 IHostTask 实例,该实例拥有由指定的 Cookie 标识的监视器。
HRESULT GetMonitorOwner (
[in] SIZE_T cookie,
[out] IHostTask *ppOwnerHostTask
);
参数
cookie
[in] 与该监视器关联的 Cookie。ppOwnerHostTask
[out] 一个指向当前拥有监视器的 IHostTask 的指针;如果任何任务都没有所属权,则为 Null。
返回值
HRESULT |
说明 |
---|---|
S_OK |
GetMonitorOwner 已成功返回。 |
HOST_E_CLRNOTAVAILABLE |
CLR 尚未加载到进程中或者处于无法运行托管代码或成功处理调用的状态。 |
HOST_E_TIMEOUT |
调用超时。 |
HOST_E_NOT_OWNER |
调用方不拥有锁。 |
HOST_E_ABANDONED |
事件在被阻止的线程或纤程正在等待它时被取消。 |
E_FAIL |
发生了未知的灾难性故障。 如果某方法返回 E_FAIL,CLR 便无法再在进程中使用。 对宿主方法的后续调用都将返回 HOST_E_CLRNOTAVAILABLE。 |
备注
宿主通常调用 GetMonitorOwner 以作为死锁检测机制的一部分。 通过调用 IHostSyncManager::CreateMonitorEvent 创建监视器后,该 Cookie 便与监视器关联。
注意 |
---|
对释放监视器的支持事件的调用可能会中断,但不会死锁,前提是对此方法的调用当前在与该监视器关联的 Cookie 中有效。其他任务如果尝试获取此监视器,也可能会中断。 |
GetMonitorOwner 总是立即返回,并可在调用 CreateMonitorEvent 后随时被调用。 在任务随着事件而产生之前,宿主不需要等待。
要求
**平台:**请参见 .NET Framework 系统要求。
**头文件:**MSCorEE.h
**库:**作为一项资源包含在 MSCorEE.dll 中
**.NET Framework 版本:**4、3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0