为公共语言运行时 (CLR) 创建一个 IHostSemaphore 对象以用作等待事件的信号灯。
语法
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 未加载到进程中，或 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 必须大于零。
要求
平台：请参阅系统要求。
标头：MSCorEE.h
库：作为资源包含在 MSCorEE.dll 中
.NET Framework 版本：自 2.0 起可用
