将指定句柄绑定到 I/O 完成端口,该端口由先前调用 CreateIoCompletionPort 而创建。
语法
HRESULT Bind (
[in] HANDLE hPort,
[in] HANDLE hHandle
);
参数
hPort
[in] 要绑定 hHandle 的 I/O 完成端口。 如果 hPort 的值为 null,则 hHandle 绑定到默认 I/O 完成端口。
hHandle
[in] 要绑定到 hPort 的操作系统句柄。
返回值
| HRESULT | 说明 |
|---|---|
| S_OK | 已成功返回 Bind。 |
| HOST_E_CLRNOTAVAILABLE | 公共语言运行时 (CLR) 未加载到进程中,或 CLR 处于无法运行托管代码或无法成功处理调用的状态。 |
| HOST_E_TIMEOUT | 调用超时。 |
| HOST_E_NOT_OWNER | 调用方未持有锁。 |
| HOST_E_ABANDONED | 阻塞的线程或纤程正在等待某一事件,而该事件已被取消。 |
| E_FAIL | 发生未知的灾难性故障。 当方法返回 E_FAIL 时,进程中无法再使用 CLR。 后续调用承载方法会返回 HOST_E_CLRNOTAVAILABLE。 |
注解
通过使用对 CreateIoCompletionPort 的调用创建 I/O 完成端口。 CLR 调用 Bind 以将句柄绑定到该端口。
备注
I/O 请求完成后,主机必须调用 ICLRIoCompletionManager::OnComplete 方法。
要求
平台:请参阅系统要求。
标头:MSCorEE.h
库:作为资源包含在 MSCorEE.dll 中
.NET Framework 版本:自 2.0 起可用