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 | 封鎖的執行緒或 Fiber 在其上等候時，事件遭到取消。 |
| 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 起可用
