IHostIoCompletionManager::InitializeHostOverlapped 方法
为宿主提供初始化要追加到 Win32 OVERLAPPED 结构（用于异步 I/O 请求）的任何自定义数据的机会。
HRESULT InitializeHostOverlapped (
[in] void* pvOverlapped
);
参数
- pvOverlapped
[in] 一个指向要包含在 I/O 请求中的 Win32 OVERLAPPED 结构的指针。
返回值
HRESULT |
说明 |
|---|---|
S_OK |
InitializeHostOverlapped 已成功返回。 |
HOST_E_CLRNOTAVAILABLE |
公共语言运行时 (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 实例的机会。
.gif "重要说明") 重要事项 |
|---|
为到达其自定义数据块的起点，宿主必须将偏移量设置为 OVERLAPPED 结构 (sizeof(OVERLAPPED)) 的大小。 |
返回值 E_OUTOFMEMORY 指示宿主未能初始化其自定义数据。 在此情况下，CLR 将报告错误，且无法进行调用。
要求
**平台：**请参见 .NET Framework 系统要求。
**头文件：**MSCorEE.h
**库：**作为一项资源包含在 MSCorEE.dll 中
**.NET Framework 版本：**4、3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0