Bagikan melalui

Metode ICLRMetaHost::GetRuntime

  • Artikel

Mendapatkan antarmuka ICLRRuntimeInfo yang sesuai dengan versi tertentu dari runtime bahasa umum (CLR). Metode ini menggantikan fungsi CorBindToRuntimeEx yang digunakan dengan bendera STARTUP_LOADER_SAFEMODE.

Sintaks

HRESULT GetRuntime (  
    [in] LPCWSTR pwzVersion,  
    [in] REFIID riid,  
    [out,iid_is(riid), retval] LPVOID *ppRuntime  
);

Parameter

pwzVersion
[masuk] Versi kompilasi .NET Framework disimpan dalam metadata, dalam format "vA. B[. X]". A, B, dan X adalah angka desimal yang sesuai dengan versi utama, versi minor, dan nomor build.

Catatan

Parameter ini harus cocok dengan nama direktori untuk versi .NET Framework, seperti yang muncul di bawah C:\Windows\Microsoft.NET\Framework atau C:\Windows\Microsoft.NET\Framework64.

Contoh nilai adalah "v1.0.3705", "v1.1.4322", "v2.0.50727", dan "v4.0. x", yang mana x tergantung pada nomor build yang dipasang. Awalan "v" diperlukan.

riid
[masuk] Pengidentifikasi untuk antarmuka yang diinginkan. Saat ini, satu-satunya nilai yang valid untuk parameter ini adalah IID_ICLRRuntimeInfo.

ppRuntime
[keluar] Penunjuk ke antarmuka ICLRRuntimeInfo yang sesuai dengan runtime bahasa umum yang diminta.

Tampilkan Nilai

Metode ini mengembalikan HRESULT tertentu berikut serta kesalahan HRESULT yang menunjukkan kegagalan metode.

HRESULT Deskripsi
S_OK Metode berhasil diselesaikan.
E_POINTER pwzVersion atau ppRuntime adalah null.

Keterangan

Metode ini berinteraksi secara konsisten dengan antarmuka lama seperti antarmuka ICorRuntimeHost dan fungsi lama seperti fungsi yang tidak CorBindTo* digunakan lagi (lihat Fungsi Hosting CLR yang tidak digunakan lagi di API hosting .NET Framework 2.0). Artinya, runtime bahasa umum yang dimuat dengan API lama dapat dilihat oleh API baru, dan runtime bahasa umum yang dimuat dengan API baru dapat dilihat oleh API lama.

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: MetaHost.h

Pustaka: Disertakan sebagai sumber daya dalam MSCorEE.dll

Versi .NET Framework: Tersedia mulai dari 4

Lihat juga