ICLRIoCompletionManager::OnComplete 方法
让公共语言运行时 (CLR) 知道通过调用 IHostIoCompletionManager::Bind 方法提出的 I/O 请求的状态。
语法
HRESULT OnComplete (
[in] DWORD dwErrorCode,
[in] DWORD NumberOfBytesTransferred,
[in] void* pvOverlapped
);
参数
dwErrorCode
[in] 一个 HRESULT 值,指示绑定操作的状态。
S_OK 指示操作已成功完成。
HOST_E_INTERRUPTED 指示调用在完成前终止。
E_FAIL 指示发生了未知且无法恢复的灾难性故障。
NumberOfBytesTransferred
[in] 处理 i/o 请求过程中传输的字节数。
pvOverlapped
[in] 指向传递给 IHostIoCompletionManager::Bind
方法调用的 OVERLAPPED
结构的指针。
返回值
HRESULT | 说明 |
---|---|
S_OK | 已成功返回 OnComplete 。 |
HOST_E_CLRNOTAVAILABLE | CLR 未加载到进程中,或 CLR 处于无法运行托管代码或无法成功处理调用的状态。 |
HOST_E_TIMEOUT | 调用超时。 |
HOST_E_NOT_OWNER | 调用方未持有锁。 |
HOST_E_ABANDONED | 阻塞的线程或纤程正在等待某一事件,而该事件已被取消。 |
E_FAIL | 发生未知的灾难性故障。 某方法返回 E_FAIL 后,进程中无法再使用 CLR。 后续调用承载方法会返回 HOST_E_CLRNOTAVAILABLE。 |
注解
如果主机实现了 I/O 完成抽象,则 CLR 会使用 IHostIoCompletionManager 方法在主机上发出 I/O 请求。 然后,主机会调用 OnComplete
方法,以通知运行时此类请求的结果。
要求
平台:请参阅系统要求。
标头:MSCorEE.h
库:作为资源包含在 MSCorEE.dll 中
.NET Framework 版本:自 2.0 起可用