ICLRRuntimeHost インターフェイス

[アーティクル]
08/09/2011

更新 : 2010 年 6 月

次の変更点を除き、.NET Framework Version 1 に用意されていた ICorRuntimeHost インターフェイスと同様の機能を提供します。

ホストのコントロールインターフェイスを設定する SetHostControl メソッドの追加。
ICorRuntimeHost で提供されていた一部のメソッドの廃止。

メソッド

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

解説

.NET Framework Version 4 以降では、ICLRMetaHost インターフェイスを使用して ICLRRuntimeInfo インターフェイスへのポインターを取得してから、ICLRRuntimeInfo::GetInterface メソッドを呼び出して ICLRRuntimeHost へのポインターを取得します。以前のバージョンの .NET Framework では、ホストは、CorBindToRuntimeEx または CorBindToCurrentRuntime を呼び出して、ICLRRuntimeHost インスタンスへのポインターを取得します。 .NET Framework Version 2.0 の技術を実装するには、ICorRuntimeHost ではなく ICLRRuntimeHost を使用する必要があります。

重要
ExecuteApplication メソッドを呼び出してマニフェストベースのアプリケーションをアクティブにしてから、Start メソッドを呼び出してください。Start メソッドを最初に呼び出すと、ExecuteApplication メソッドの呼び出しは失敗します。