ICLRMetaHost インターフェイスICLRMetaHost Interface

そのバージョン番号に基づく共通言語ランタイム (CLR) の特定のバージョンを返す、インストールされている Clr のすべてを一覧表示、指定されたプロセスに読み込まれるすべてのランタイムの一覧で、アセンブリをコンパイル、プロセスを終了するために使用する CLR のバージョンを検出するメソッドを提供します。ランタイムがクリーン シャット ダウンとクエリのレガシ API バインドします。Provides methods that return a specific version of the common language runtime (CLR) based on its version number, list all installed CLRs, list all runtimes that are loaded in a specified process, discover the CLR version used to compile an assembly, exit a process with a clean runtime shutdown, and query legacy API binding.


メソッドMethod 説明Description
EnumerateInstalledRuntimes メソッドEnumerateInstalledRuntimes Method 含む、有効な列挙体を返しますICLRRuntimeInfoコンピューターにインストールされている CLR のバージョンごとにインターフェイス ポインター。Returns an enumeration that contains a valid ICLRRuntimeInfo interface pointer for each CLR version that is installed on a computer.
EnumerateLoadedRuntimes メソッドEnumerateLoadedRuntimes Method 含む、有効な列挙体を返しますICLRRuntimeInfo特定のプロセスに読み込まれる各 CLR 用のインターフェイス ポインター。Returns an enumeration that contains a valid ICLRRuntimeInfo interface pointer for each CLR that is loaded in a given process. このメソッドはGetVersionFromProcessします。This method supersedes GetVersionFromProcess.
ExitProcess メソッドExitProcess Method すべての読み込まれたランタイムを適切にシャット ダウンしようとしてのプロセスを終了します。Attempts to shut down all loaded runtimes gracefully and then terminates the process. も優先されます、 CorExitProcess関数。Supersedes the CorExitProcess function.
GetRuntime メソッドGetRuntime Method 取得、 ICLRRuntimeInfo特定の CLR バージョンに対応するインターフェイス。Gets the ICLRRuntimeInfo interface that corresponds to a particular CLR version. このメソッドは、 CorBindToRuntimeExで使用される関数、 STARTUP_LOADER_SAFEMODEフラグ。This method supersedes the CorBindToRuntimeEx function used with the STARTUP_LOADER_SAFEMODE flag.
GetVersionFromFile メソッドGetVersionFromFile Method 指定されたファイル パスから、アセンブリの元の .NET Framework コンパイル バージョン (メタデータに格納されている) を取得します。Gets the assembly's original .NET Framework compilation version (stored in the metadata), given its file path. このメソッドはGetFileVersionします。This method supersedes GetFileVersion.
QueryLegacyV2RuntimeBinding メソッドQueryLegacyV2RuntimeBinding Method レガシ アクティブ化ポリシーが関連付けられて、例を使用してランタイムを表すインターフェイスを返します、useLegacyV2RuntimeActivationPolicy属性を <startup > 要素ダイレクトを使用して、構成ファイルのエントリレガシ アクティブ化 Api、または呼び出すことによって、 iclrruntimeinfo::bindaslegacyv2runtimeメソッド。Returns an interface that represents a runtime to which legacy activation policy has been bound, for example by using the useLegacyV2RuntimeActivationPolicy attribute on the <startup> Element configuration file entry, by direct use of the legacy activation APIs, or by calling the ICLRRuntimeInfo::BindAsLegacyV2Runtime method.
RequestRuntimeLoadedNotification メソッドRequestRuntimeLoadedNotification Method CLR バージョンは、最初に読み込まれたが、開始していない場合に、指定した関数ポインターへのコールバックを保証します。Guarantees a callback to the specified function pointer when a CLR version is first loaded, but not yet started. このメソッドはLockClrVersionThis method supersedes LockClrVersion


このインターフェイスのインスタンスを取得する唯一の方法は、呼び出すことによって、 CLRCreateInstance関数の次のようにします。The only way to get an instance of this interface is by calling the CLRCreateInstance function as follows:

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


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

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

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

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

関連項目See also