ICLRMetaHost インターフェイス

  • [アーティクル]

バージョン番号に基づいて特定のバージョンの共通言語ランタイム (CLR) を返し、インストールされているすべての CLR を一覧表示し、指定されたプロセスに読み込まれているすべてのランタイムを一覧表示し、アセンブリをコンパイルするために使用された CLR バージョンを検出し、クリーン ランタイム シャットダウンを使用してプロセスを終了し、レガシ API バインディングを照会するメソッドを提供します。

メソッド

メソッド 説明
EnumerateInstalledRuntimes メソッド コンピューターにインストールされている各 CLR バージョンの有効な ICLRRuntimeInfo インターフェイス ポインターを含む列挙を返します。
EnumerateLoadedRuntimes メソッド 指定したプロセスに読み込まれる CLR ごとに、有効な ICLRRuntimeInfo インターフェイス ポインターを格納した列挙型を返します。 このメソッドは、GetVersionFromProcess よりも優先されます。
ExitProcess メソッド 読み込まれたすべてのランタイムを正常にシャットダウンしてから、プロセスを終了しようとします。 CorExitProcess 関数よりも優先されます。
GetRuntime メソッド 特定の CLR バージョンに対応する ICLRRuntimeInfo インターフェイスを取得します。 このメソッドは、STARTUP_LOADER_SAFEMODEフラグと共に使用される CorBindToRuntimeEx 関数よりも優先されます。
GetVersionFromFile メソッド ファイルパスを指定して、アセンブリの元の .NET Framework コンパイルバージョン (メタデータに格納されている) を取得します。 このメソッドは、GetFileVersion よりも優先されます。
QueryLegacyV2RuntimeBinding メソッド <startup> 要素構成ファイル エントリの useLegacyV2RuntimeActivationPolicy 属性を使用するか、レガシ アクティブ化 API を直接使用するか、または ICLRRuntimeInfo::BindAsLegacyV2Runtime メソッドを呼び出して、レガシ アクティブ化ポリシーがバインドされているランタイムを表すインターフェイスを返します。
RequestRuntimeLoadedNotification メソッド CLR バージョンが最初に読み込まれたものの、まだ起動されていない場合に、指定された関数ポインターへのコールバックを保証します。 このメソッドは、LockClrVersion よりも優先されます

解説

このインターフェイスのインスタンスを取得する唯一の方法は、次のように CLRCreateInstance 関数を呼び出すことです。

ICLRMetaHost *pMetaHost = NULL;  
HRESULT hr = CLRCreateInstance(CLSID_CLRMetaHost,  
                   IID_ICLRMetaHost, (LPVOID*)&pMetaHost);

必要条件

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

ヘッダー: MetaHost.h

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

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

関連項目