ICLRSyncManager::CreateRWLockOwnerIterator 方法

项目
08/12/2011

请求公共语言运行时 (CLR) 创建一个迭代器，供宿主用于确定在读取器-编写器锁中处于等待状态的一组任务。

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

参数

cookie
[in] 与所需读取器-编写器锁关联的 Cookie。
pIterator
[out] 一个指向可传递到 GetRWLockOwnerNext 和 DeleteRWLockOwnerIterator 方法的迭代器的指针。

返回值

HRESULT	说明
S_OK	CreateRWLockOwnerIterator 已成功返回。
HOST_E_CLRNOTAVAILABLE	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 不会尝试使读取器-编写器锁处于活动状态。宿主可使用若干策略来确保锁的有效性：