IHostIoCompletionManager::InitializeHostOverlapped 方法
提供主應用程式初始化任何自訂資料的機會，以附加到用於非同步 I/O 要求的 Win32 OVERLAPPED 結構。
HRESULT InitializeHostOverlapped (
[in] void* pvOverlapped
);
參數
- pvOverlapped
[in] 要包含在 I/O 要求中的 Win32 OVERLAPPED 結構之指標。
傳回值
HRESULT |
描述 |
|---|---|
S_OK |
InitializeHostOverlapped 已成功傳回。 |
HOST_E_CLRNOTAVAILABLE |
Common Language Runtime (CLR) 尚未載入至處理序中，或者此 CLR 目前的狀態無法執行 Managed 程式碼或成功處理呼叫。 |
HOST_E_TIMEOUT |
呼叫已逾時。 |
HOST_E_NOT_OWNER |
呼叫端不具備鎖定功能。 |
HOST_E_ABANDONED |
已封鎖執行緒或 Fiber 在等候事件時，該事件已遭取消。 |
E_FAIL |
發生未知的重大錯誤。 當方法傳回 E_FAIL 時，便無法在處理序內使用 CLR。 對裝載方法的後續呼叫會傳回 HOST_E_CLRNOTAVAILABLE。 |
E_OUTOFMEMORY |
可用的記憶體不足，無法配置所要求的資源。 |
備註
Windows Platform 函式會使用 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