IHostSyncManager::CreateSemaphore 方法
创建一个 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 必须大于零。
要求
**平台:**请参见 .NET Framework 系统要求。
**头文件:**MSCorEE.h
**库:**作为一项资源包含在 MSCorEE.dll 中
**.NET Framework 版本:**4、3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0