IHostIoCompletionManager::GetHostOverlappedSize 方法
获取主机打算追加到 I/O 请求的任何自定义数据的大小。
语法
HRESULT GetHostOverlappedSize (
[out] DWORD *pcbSize
);
参数
pcbSize
[out] 指向公共语言运行时 (CLR) 应分配的字节数，以及 Win32 OVERLAPPED 对象的大小。
返回值
| HRESULT | 说明 |
|---|---|
| S_OK | 已成功返回 GetHostOverlappedSize。 |
| HOST_E_CLRNOTAVAILABLE | CLR 未加载到进程中，或 CLR 处于无法运行托管代码或无法成功处理调用的状态。 |
| HOST_E_TIMEOUT | 调用超时。 |
| HOST_E_NOT_OWNER | 调用方未持有锁。 |
| HOST_E_ABANDONED | 阻塞的线程或纤程正在等待某一事件，而该事件已被取消。 |
| E_FAIL | 发生未知的灾难性故障。 当方法返回 E_FAIL 时，进程中无法再使用 CLR。 后续调用承载方法会返回 HOST_E_CLRNOTAVAILABLE。 |
注解
对 Windows 平台 API 的所有异步 I/O 调用都采用 Win32 OVERLAPPED 对象，后者提供了文件指针位置等信息。 要维护状态，执行异步 I/O 调用的应用程序通常会将自定义数据添加到该结构中。 GetHostOverlappedSize 和 IHostIoCompletionManager::InitializeHostOverlapped 为主机提供了机会，使其包含此类自定义数据。
CLR 调用 GetHostOverlappedSize 方法来确定主机打算追加到 OVERLAPPED 对象的自定义数据的大小。
备注
GetHostOverlappedSize 只调用一次。 主机的自定义数据必须与每个 I/O 请求的大小相同。
重要
OVERLAPPED 对象本身的大小不包含在的 pcbSize 值中。
有关 OVERLAPPED 结构的详细信息，请参阅 Windows 平台文档。
要求
平台：请参阅系统要求。
标头：MSCorEE.h
库：作为资源包含在 MSCorEE.dll 中
.NET Framework 版本：自 2.0 起可用
