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 未加载到进程中,或 CLR 处于无法运行托管代码或无法成功处理调用的状态。 |
HOST_E_TIMEOUT | 调用超时。 |
HOST_E_NOT_OWNER | 调用方未持有锁。 |
HOST_E_ABANDONED | 阻塞的线程或纤程正在等待某一事件,而该事件已被取消。 |
E_FAIL | 发生未知的灾难性故障。 当方法返回 E_FAIL 时,进程中无法再使用 CLR。 后续调用承载方法会返回 HOST_E_CLRNOTAVAILABLE。 |
备注
作为死锁检测机制的一部分,主机通常会调用 GetMonitorOwner
。 使用对 IHostSyncManager::CreateMonitorEvent 的调用创建 Cookie 时,Cookie 会与监视器关联。
备注
如果对此方法的调用当前对与该监视器关联的 Cookie 有效,则对释放监视器基础事件的调用可能会阻塞,但不会死锁。 如果其他任务尝试获取此监视器,也可能被阻塞。
GetMonitorOwner
始终立即返回,并且可以在调用 CreateMonitorEvent
后随时调用。 在任务等待事件之前,主机无需等待。
要求
平台:请参阅系统要求。
标头:MSCorEE.h
库:作为资源包含在 MSCorEE.dll 中
.NET Framework 版本:自 2.0 起可用