Bagikan melalui


Antarmuka ICLRMetaHost

Menyediakan metode yang mengembalikan versi tertentu dari runtime bahasa umum (CLR) berdasarkan nomor versinya, mencantumkan semua CLR yang diinstal, mencantumkan semua runtime yang dimuat dalam proses tertentu, menemukan versi CLR yang digunakan untuk mengkompilasi rakitan, keluar dari proses dengan pematian runtime bersih, dan mengkueri pengikatan API warisan.

Methods

Metode Description
Metode EnumerateInstalledRuntimes Mengembalikan enumerasi yang berisi penunjuk antarmuka ICLRRuntimeInfo yang valid untuk setiap versi CLR yang diinstal di komputer.
Metode EnumerateLoadedRuntimes Mengembalikan enumerasi yang berisi penunjuk antarmuka ICLRRuntimeInfo yang valid untuk setiap CLR yang dimuat dalam proses tertentu. Metode ini menggantikan GetVersionFromProcess.
Metode ExitProcess Mencoba mematikan semua runtime yang dimuat dengan anggun dan kemudian mengakhiri proses. Menggantikan fungsi CorExitProcess .
Metode GetRuntime Mendapatkan antarmuka ICLRRuntimeInfo yang sesuai dengan versi CLR tertentu. Metode ini menggantikan fungsi CorBindToRuntimeEx yang digunakan dengan bendera STARTUP_LOADER_SAFEMODE .
Metode GetVersionFromFile Mendapatkan versi kompilasi .NET Framework asli assembly (disimpan dalam metadata), mengingat jalur filenya. Metode ini menggantikan GetFileVersion.
Metode QueryLegacyV2RuntimeBinding Mengembalikan antarmuka yang mewakili runtime tempat kebijakan aktivasi warisan terikat, misalnya dengan menggunakan useLegacyV2RuntimeActivationPolicy atribut pada <startup> entri file konfigurasi Elemen, dengan penggunaan langsung API aktivasi warisan, atau dengan memanggil metode ICLRRuntimeInfo::BindAsLegacyV2Runtime.
Metode RequestRuntimeLoadedNotification Menjamin panggilan balik ke penunjuk fungsi yang ditentukan saat versi CLR pertama kali dimuat, tetapi belum dimulai. Metode ini menggantikan LockClrVersion

Komentar

Satu-satunya cara untuk mendapatkan instans antarmuka ini adalah dengan memanggil fungsi CLRCreateInstance sebagai berikut:

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

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: MetaHost.h

Perpustakaan: Disertakan sebagai sumber daya dalam MSCorEE.dll

Versi .NET Framework: Tersedia sejak 4

Lihat juga