IHostSyncManager::CreateRWLockReaderEvent 方法

为实现读取器锁创建手动重置事件对象。

HRESULT CreateRWLockReaderEvent (
    [in]  BOOL bInitialState,
    [in]  SIZE_T cookie,
    [out] IHostManualEvent **ppEvent
);

参数

  • bInitialState
    [in] 如果 ppEvent 应为终止状态,则为 true,否则为 false。

  • cookie
    [in] 要与该读取器锁关联的 Cookie。

  • ppEvent
    [out] 一个指向 IHostManualEvent 实例的地址的指针;如果未能创建该事件对象,则为 Null。

返回值

HRESULT

说明

S_OK

CreateRWLockReaderEvent 已成功返回。

HOST_E_CLRNOTAVAILABLE

公共语言运行时 (CLR) 尚未加载到进程中或者处于无法运行托管代码或成功处理调用的状态。

HOST_E_TIMEOUT

调用超时。

HOST_E_NOT_OWNER

调用方不拥有锁。

HOST_E_ABANDONED

事件在被阻止的线程或纤程正在等待它时被取消。

E_FAIL

发生了未知的灾难性故障。 如果某方法返回 E_FAIL,CLR 便无法再在进程中使用。 对宿主方法的后续调用都将返回 HOST_E_CLRNOTAVAILABLE。

E_OUTOFMEMORY

没有可用于创建请求的事件对象的足够内存。

备注

CLR 通过调用 CreateRWLockReaderEvent 来获取对 IHostManualEvent 实例的引用,以便在其实现读取器锁时使用。 宿主可以通过查询 ICLRSyncManager 接口使用 Cookie 来确定哪些任务在等待读取器锁。

要求

**平台:**请参见 .NET Framework 系统要求

**头文件:**MSCorEE.h

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

**.NET Framework 版本:**4、3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0

请参见

参考

ICLRSyncManager 接口

IHostAutoEvent 接口

IHostManualEvent 接口

IHostSyncManager 接口