IHostIoCompletionManager::InitializeHostOverlapped 方法
为主机提供初始化任何自定义数据以附加到用于异步 I/O 请求的 Win32 OVERLAPPED 结构的机会。
语法
HRESULT InitializeHostOverlapped (
[in] void* pvOverlapped
);
参数
pvOverlapped
[in] 指向要包含在 I/O 请求中的 Win32 OVERLAPPED 结构的指针。
返回值
| HRESULT | 说明 |
|---|---|
| S_OK | 已成功返回 InitializeHostOverlapped。 |
| 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 | 内存不足，无法分配请求资源。 |
注解
Windows平台函数使用 OVERLAPPED 结构来存储异步 I/O 请求的状态。 CLR 调用 InitializeHostOverlapped 方法，使主机有机会将自定义数据追加到 OVERLAPPED 实例。
重要
若要到达其自定义数据块的开头，主机必须将偏移量设置为 OVERLAPPED 结构 (sizeof(OVERLAPPED)) 的大小。
返回值 E_OUTOFMEMORY 表示主机未能初始化其自定义数据。 在这种情况下，CLR 报告错误，且调用失败。
要求
平台：请参阅系统要求。
标头：MSCorEE.h
库：作为资源包含在 MSCorEE.dll 中
.NET Framework 版本：自 2.0 起可用
