IHostIoCompletionManager::CreateIoCompletionPort メソッド

ホストに新しい I/O 完了ポートを作成することを要求します。

構文

HRESULT CreateIoCompletionPort (  
    [out] HANDLE *phPort  
);  

パラメーター

phPort
[out] 新しく作成された I/O 完了ポートのハンドルへのポインター。ポートを作成できなかった場合は 0 (ゼロ)。

戻り値

HRESULT	説明
S_OK	CreateIoCompletionPort が正常に返されました。
HOST_E_CLRNOTAVAILABLE	共通言語ランタイム (CLR) がプロセスに読み込まれていないか、CLR がマネージド コードを実行できないまたは呼び出しを正常に処理できない状態です。
HOST_E_TIMEOUT	呼び出しがタイムアウトになりました。
HOST_E_NOT_OWNER	呼び出し元がロックを所有していません。
HOST_E_ABANDONED	ブロックされたスレッドまたはファイバーが待機しているときに、イベントが取り消されました。
E_FAIL	原因不明の致命的なエラーが発生しました。 メソッドにより E_FAIL が返されると、そのプロセス内で CLR が使用できなくなります。 後続のホスティング メソッドの呼び出しでは HOST_E_CLRNOTAVAILABLE が返されます。
E_OUTOFMEMORY	メモリ不足のため、要求されたリソースを割り当てられませんでした。

解説

ホストで新しい I/O 完了ポートを作成するように要求するために、CLR で CreateIoCompletionPort メソッドが呼び出されます。 IHostIoCompletionManager::Bind メソッドを呼び出すと、このポートに I/O 操作がバインドされます。 ICLRIoCompletionManager::OnComplete を呼び出すと、ホストから状態が CLR に戻されます。

必要条件

:「システム要件」を参照してください。

ヘッダー: MSCorEE.h

ライブラリ: MSCorEE.dll にリソースとして含まれます

.NET Framework のバージョン: 2.0 以降で使用可能

関連項目

• ICLRIoCompletionManager インターフェイス
• IHostIoCompletionManager インターフェイス