ICLRRuntimeHost インターフェイス

  • [アーティクル]

.NET Framework バージョン 1 で提供される ICorRuntimeHost インターフェイスと同様の機能を提供しますが、次の変更点があります。

  • ホスト コントロール インターフェイスを設定するための SetHostControl メソッドの追加。

  • ICorRuntimeHost によって提供されるいくつかのメソッドの省略。

メソッド

メソッド 説明
ExecuteApplication メソッド 新しいドメインでアクティブ化するアプリケーションを指定するために、マニフェスト ベースの ClickOnce デプロイ シナリオで使用されます。
ExecuteInAppDomain メソッド マネージド コード クラスを実行する先の AppDomain を指定します。
ExecuteInDefaultAppDomain メソッド 指定されたアセンブリ内で、指定された型の指定されたメソッドを呼び出します。
GetCLRControl メソッド ホストによる共通言語ランタイム (CLR) の側面のカスタマイズで使用できる ICLRControl 型のインターフェイス ポインターを取得します。
GetCurrentAppDomainId メソッド 現在実行中の AppDomain の数値識別子を取得します。
SetHostControl メソッド ホスト コントロール インターフェイスを設定します。 Start の前に SetHostControl を呼び出す必要があります。
Start メソッド CLR をプロセスに初期化します。
Stop メソッド ランタイムによるコードの実行を停止します。
UnloadAppDomain メソッド 指定された数値識別子に対応する AppDomain をアンロードします。

解説

.NET Framework 4 以降では、ICLRMetaHost インターフェイスを使用して ICLRRuntimeInfo インターフェイスへのポインターを取得し、次に ICLRRuntimeInfo::GetInterface メソッドを呼び出して、ICLRRuntimeHost へのポインターを取得します。 以前のバージョンの .NET Framework では、ホストは CorBindToRuntimeEx または CorBindToCurrentRuntime を呼び出すことによって、ICLRRuntimeHost インスタンスへのポインターを取得します。 .NET Framework バージョン 2.0 で提供されるテクノロジの実装を提供するには、ICorRuntimeHost の代わりに ICLRRuntimeHost を使用する必要があります。

重要

ExecuteApplication メソッドを呼び出してマニフェストベースのアプリケーションをアクティブ化する前に、Start メソッドを呼び出さないでください。 Start メソッドが最初に呼び出された場合、ExecuteApplication メソッドの呼び出しは失敗します。

必要条件

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

ヘッダー: MSCorEE.h

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

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

関連項目