ICLRRuntimeHost::SetHostControl メソッドICLRRuntimeHost::SetHostControl Method

共通言語ランタイム (CLR) のホストの実装の取得に使用できるインターフェイス ポインターを設定しますIHostControl インターフェイスします。Sets the interface pointer that the common language runtime (CLR) can use to get the host's implementation of IHostControl Interface.


HRESULT SetHostControl(  
    [in] IHostControl* pHostControl  


[in]ホストの実装へのインターフェイス ポインター IHostControl インターフェイスします。[in] An interface pointer to the host's implementation of IHostControl Interface.

戻り値Return Value

S_OKS_OK SetHostControl 正常に返されます。SetHostControl returned successfully.
HOST_E_CLRNOTAVAILABLEHOST_E_CLRNOTAVAILABLE プロセスに CLR が読み込まれていないか、CLR は状態をマネージ コードを実行または呼び出しを正常に処理ができません。The CLR has not been loaded into a process, or the CLR is in a state in which it cannot run managed code or process the call successfully.
HOST_E_TIMEOUTHOST_E_TIMEOUT 呼び出しがタイムアウトになりました。The call timed out.
HOST_E_NOT_OWNERHOST_E_NOT_OWNER 呼び出し元がロックを所有していません。The caller does not own the lock.
HOST_E_ABANDONEDHOST_E_ABANDONED イベントがキャンセルされましたブロックされたスレッドまたはファイバーが待機しています。An event was canceled while a blocked thread or fiber was waiting on it.
E_FAILE_FAIL 不明な致命的なエラーが発生しました。An unknown catastrophic failure occurred. メソッドから E_FAIL が返された場合、CLR は、プロセス内で使用可能ではなくなりました。If a method returns E_FAIL, the CLR is no longer usable within the process. メソッドをホストする後続の呼び出しには、HOST_E_CLRNOTAVAILABLE が返されます。Subsequent calls to hosting methods return HOST_E_CLRNOTAVAILABLE.
E_CLR_ALREADY_STARTEDE_CLR_ALREADY_STARTED CLR は既に初期化されています。The CLR has already been initialized.


呼び出す必要がありますSetHostControl、CLR が初期化される前に、つまり、呼び出す前にStart メソッドのいずれかを使用、メタデータ インターフェイスします。You must call SetHostControl before the CLR is initialized, that is, before you call Start Method or use any of the Metadata Interfaces. 呼び出すことをお勧めSetHostControl呼び出した直後後CorBindToCurrentRuntime 関数またはCorBindToRuntimeEx 関数します。It is recommended that you call SetHostControl immediately after calling CorBindToCurrentRuntime Function or CorBindToRuntimeEx Function.


プラットフォーム:システム要件に関するページを参照してください。Platforms: See System Requirements.

ヘッダー: MSCorEE.hHeader: MSCorEE.h

ライブラリ: MSCorEE.dll でリソースとして含まれますLibrary: Included as a resource in MSCorEE.dll

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

関連項目See also