ICLRRuntimeHost インターフェイスICLRRuntimeHost Interface

.NET Framework バージョン1で提供されるICorRuntimeHostインターフェイスと同様の機能を提供します。次の変更点があります。Provides functionality similar to that of the ICorRuntimeHost interface provided in the .NET Framework version 1, with the following changes:

  • ホストコントロールインターフェイスを設定するためのSethostcontrolメソッドの追加。The addition of the SetHostControl method to set the host control interface.

  • によっICorRuntimeHostて提供されるいくつかのメソッドの省略。The omission of some methods provided by ICorRuntimeHost.

メソッドMethods

メソッドMethod 説明Description
ExecuteApplication メソッドExecuteApplication Method 新しいドメインでアクティブ化するアプリケーションを指定するために、マニフェストベースの ClickOnce 配置シナリオで使用されます。Used in manifest-based ClickOnce deployment scenarios to specify the application to be activated in a new domain.
ExecuteInAppDomain メソッドExecuteInAppDomain Method AppDomain指定したマネージコードを実行するを指定します。Specifies the AppDomain in which to execute the specified managed code.
ExecuteInDefaultAppDomain メソッドExecuteInDefaultAppDomain Method 指定したアセンブリ内で、指定した型の指定したメソッドを呼び出します。Invokes the specified method of the specified type in the specified assembly.
GetCLRControl メソッドGetCLRControl Method ホストが共通言語ランタイム (CLR) の側面をカスタマイズするために使用できる、 ICLRControl型のインターフェイスポインターを取得します。Gets an interface pointer of type ICLRControl that hosts can use to customize aspects of the common language runtime (CLR).
GetCurrentAppDomainId メソッドGetCurrentAppDomainId Method 現在実行中ののAppDomain数値識別子を取得します。Gets the numeric identifier of the AppDomain that is currently executing.
SetHostControl メソッドSetHostControl Method ホストコントロールインターフェイスを設定します。Sets the host control interface. を呼び出すSetHostControl Start前に、を呼び出す必要があります。You must call SetHostControl before calling Start.
Start メソッドStart Method CLR をプロセスに初期化します。Initializes the CLR into a process.
Stop メソッドStop Method ランタイムによるコードの実行を停止します。Stops the execution of code by the runtime.
UnloadAppDomain メソッドUnloadAppDomain Method 指定した数値識別子に対応するをアンロードします。AppDomainUnloads the AppDomain that corresponds to the specified numeric identifier.

RemarksRemarks

.NET Framework 4 以降では、 ICLRMetaHostインターフェイスを使用してICLRRuntimeInfoインターフェイスへのポインターを取得し、 ICLRRuntimeInfo:: getinterfaceメソッドを呼び出して、へICLRRuntimeHostのポインターを取得します。Starting with the .NET Framework 4, use the ICLRMetaHost interface to get a pointer to the ICLRRuntimeInfo interface, and then call the ICLRRuntimeInfo::GetInterface method to get a pointer to ICLRRuntimeHost. 以前のバージョンの .NET Framework では、ホストはICLRRuntimeHost corbindtoruntimeexまたはcorbindtoの entruntimeを呼び出すことによって、インスタンスへのポインターを取得します。In earlier versions of the .NET Framework, the host gets a pointer to an ICLRRuntimeHost instance by calling CorBindToRuntimeEx or CorBindToCurrentRuntime. .NET Framework バージョン2.0 で提供されるテクノロジの実装を提供するには、のICLRRuntimeHost ICorRuntimeHost代わりにを使用する必要があります。To provide implementations of any of the technologies provided in the .NET Framework version 2.0, you must use ICLRRuntimeHost instead of ICorRuntimeHost.

重要

マニフェストベースのアプリケーションをアクティブ化するには、 Executeapplicationメソッドを呼び出す前にStartメソッドを呼び出さないでください。Do not call the Start method before calling the ExecuteApplication method to activate a manifest-based application. メソッドが最初ExecuteApplicationに呼び出された場合、メソッドの呼び出しは失敗します。 StartIf the Start method is called first, the ExecuteApplication method call will fail.

必要条件Requirements

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

ヘッダー: Mscoree.dllHeader: 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