IHostSyncManager::CreateSemaphore 方法

项目
08/12/2011

创建一个 IHostSemaphore 对象，供公共语言运行时 (CLR) 用作等待事件的信号量。

HRESULT CreateSemaphore (
    [in]  DWORD dwInitial,
    [in]  DWORD dwMax,
    [out] IHostSemaphore **ppSemaphore
);

参数

dwInitial
[in] ppSemaphore 的初始计数。
dwMax
[in] ppSemaphore 的最大计数。
ppSemaphore
[out] 一个指向 IHostSemaphore 实例地址的指针；如果未能创建该信号量，则为 Null。

返回值

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

备注

CreateSemaphore 镜像具有相同名称的 Win32 函数。参数 dwInitial 和 dwMax 分别与 Win32 参数 lInitialCount 和 lMaximumCount 使用相同的信号量计数语义。 dwInitial 必须介于零和 dwMax 之间（均含）。 dwMax 必须大于零。