通过

ICLRSyncManager::CreateRWLockOwnerIterator 方法

  • 项目

请求公共语言运行时 (CLR) 为主机创建一个迭代器，用于确定等待读写锁的一组任务。

语法

HRESULT CreateRWLockOwnerIterator (  
    [in]  SIZE_T    cookie,  
    [out] SIZE_T   *pIterator  
);

参数

cookie
[in] 与所需读取器-编写器锁关联的 Cookie。

pIterator
[out] 指向可传递给 和 DeleteRWLockOwnerIterator 方法的迭代器的指针。

返回值

HRESULT 说明
S_OK 已成功返回 CreateRWLockOwnerIterator。
HOST_E_CLRNOTAVAILABLE CLR 未加载到进程中，或 CLR 处于无法运行托管代码或无法成功处理调用的状态。
HOST_E_TIMEOUT 调用超时。
HOST_E_NOT_OWNER 调用方未持有锁。
HOST_E_ABANDONED 阻塞的线程或纤程正在等待某一事件，而该事件已被取消。
E_FAIL 发生未知的灾难性故障。 当方法返回 E_FAIL 时，进程中无法再使用 CLR。 后续调用承载方法会返回 HOST_E_CLRNOTAVAILABLE。
HOST_E_INVALIDOPERATION 当前正在运行托管代码的线程上调用了 CreateRWLockOwnerIterator。

备注

主机通常在死锁检测期间调用 CreateRWLockOwnerIterator、DeleteRWLockOwnerIterator 和 GetRWLockOwnerNext 方法。 主机负责确保读取器-编写器锁仍然有效，因为 CLR 不会尝试使读取器-编写器锁保持活动状态。 主机可以使用多种策略来确保锁的有效性：

  • 主机可以阻止对读取器-编写器锁的释放调用（例如 IHostSemaphore::ReleaseSemaphore），同时确保此阻止不会导致死锁。

  • 主机可以阻止退出等待与读取器-编写器锁关联的事件对象，再次确保此阻止不会导致死锁。

备注

必须仅在当前正在执行非托管代码的线程上调用 CreateRWLockOwnerIterator。

要求

平台：请参阅系统要求。

标头：MSCorEE.h

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

.NET Framework 版本：自 2.0 起可用

另请参阅