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 起可用

另请参阅