IHostIoCompletionManager::GetHostOverlappedSize 方法

项目
08/12/2011

获取宿主要附加到 I/O 请求的任何自定义数据的大小。

HRESULT GetHostOverlappedSize (
    [out] DWORD *pcbSize
);

参数

pcbSize
[out] 一个指针，指向除了 Win32 OVERLAPPED 对象的大小之外公共语言运行时 (CLR) 应分配的字节数。

返回值

HRESULT	说明
S_OK	GetHostOverlappedSize 已成功返回。
HOST_E_CLRNOTAVAILABLE	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 对象的自定义数据的大小。