IHostSyncManager::CreateManualEvent 方法

2008-08-18

更新：2007 年 11 月

创建手动重置的事件对象。

HRESULT CreateManualEvent (
    [in]  BOOL bInitialState,
    [out] IHostManualEvent **ppEvent
);

参数

bInitialState
[in] 如果对象为终止状态，则为 true；否则为 false。
ppEvent
[out] 一个指向 IHostManualEvent 实例的地址的指针；如果无法创建该事件，则为 Null。

返回值

HRESULT	说明
S_OK	CreateManualEvent 成功返回。
HOST_E_CLRNOTAVAILABLE	公共语言运行库 (CLR) 尚未加载到进程中或者处于无法运行托管代码或成功处理调用的状态。
HOST_E_TIMEOUT	调用超时。
HOST_E_NOT_OWNER	调用方不拥有锁。
HOST_E_ABANDONED	事件在被阻止的线程或纤程正在等待它时被取消。
E_FAIL	发生了未知的灾难性故障。如果某方法返回 E_FAIL，CLR 便无法再在进程中使用。对宿主方法的后续调用都将返回 HOST_E_CLRNOTAVAILABLE。
E_OUTOFMEMORY	没有可用于创建请求的事件对象的足够内存。

备注

CreateManualEvent 会创建一个手动重置事件对象 IHostManualEvent，需要调用 IHostManualEvent::Reset 方法才能将此对象设置为非终止状态。当为 bManualReset 参数指定的值为 true 时，CreateManualEvent 将镜像 Win32 CreateEvent 函数。