Bagikan melalui

Fungsi CorBindToRuntimeHost

  • Artikel

Memungkinkan host memuat versi tertentu dari runtime bahasa umum (CLR) ke dalam proses.

Fungsi ini tidak digunakan lagi di .NET Framework 4.

Sintaks

HRESULT CorBindToRuntimeHost (  
    [in] LPCWSTR       pwszVersion,
    [in] LPCWSTR       pwszBuildFlavor,
    [in] LPCWSTR       pwszHostConfigFile,
    [in] VOID*         pReserved,
    [in] DWORD         startupFlags,
    [in] REFCLSID      rclsid,
    [in] REFIID        riid,
    [out] LPVOID FAR  *ppv  
);

Parameter

pwszVersion
[in] String yang menjelaskan versi CLR yang ingin Anda muat.

Nomor versi dalam .NET Framework terdiri dari empat bagian yang dipisahkan oleh titik: major.minor.build.revision. String yang diteruskan sebagai pwszVersion harus diawali dengan karakter "v" diikuti oleh tiga bagian pertama dari nomor versi (misalnya, "v1.0.1529").

Beberapa versi CLR diinstal dengan pernyataan kebijakan yang menentukan kompatibilitas dengan versi CLR sebelumnya. Secara default, shim pengaktifan mengevaluasi pwszVersion terhadap pernyataan kebijakan dan memuat versi terbaru runtime yang kompatibel dengan versi yang diminta. Host dapat memaksa shim untuk melewati evaluasi kebijakan dan memuat versi yang tepat yang ditentukan dengan pwszVersion meneruskan nilai STARTUP_LOADER_SAFEMODE untuk parameterstartupFlags.

Jika pwszVersion adalah null,, metode tidak memuat versi CLR apa pun. Sebaliknya, inia mengembalikan CLR_E_SHIM_RUNTIMELOAD, yang menunjukkan bahwa ini gagal memuat runtime.

pwszBuildFlavor
[in] String yang menentukan apakah akan memuat server atau build stasiun kerja CLR. Nilai yang berlaku adalah svr atau wks. Build server dioptimalkan untuk memanfaatkan beberapa prosesor untuk pengumpulan sampah, dan build stasiun kerja dioptimalkan untuk aplikasi klien yang berjalan di komputer prosesor tunggal.

Jika pwszBuildFlavor diatur ke null, build stasiun kerja dimuat. Saat berjalan di komputer prosesor tunggal, build stasiun kerja selalu dimuat, meskipun pwszBuildFlavor diatur ke svr. Namun, jika pwszBuildFlavor diatur ke svr dan pengumpulan sampah serentak ditentukan (lihat deskripsi parameter startupFlags), build server dimuat.

Catatan

Pengumpulan sampah serentak tidak didukung dalam aplikasi yang menjalankan emulator WOW64 x86 pada sistem 64-bit yang menerapkan arsitektur Intel Itanium (sebelumnya disebut IA-64). Untuk informasi selengkapnya tentang menggunakan WOW64 pada sistem Windows 64-bit, lihat Menjalankan Aplikasi 32-bit.

pwszHostConfigFile
[in] Nama file konfigurasi host yang menentukan versi CLR yang akan dimuat. Jika nama file tidak menyertakan jalur yang sepenuhnya memenuhi syarat, file diasumsikan berada dalam direktori yang sama dengan executable yang melakukan panggilan.

pReserved
[in] Dicadangkan untuk ekstensibilitas di masa mendatang.

startupFlags
[in] Sekumpulan bendera yang mengontrol pengumpulan sampah serentak, kode netral domain, dan perilaku parameter pwszVersion. Defaultnya adalah domain tunggal jika tidak ada bendera yang diatur. Untuk daftar nilai yang didukung, lihat enumerasi STARTUP_FLAGS.

rclsid
[in] CLSID dari coclass yang mengimplementasikan antarmuka ICorRuntimeHost atau ICLRRuntimeHost. Nilai yang didukung adalah CLSID_CorRuntimeHost atau CLSID_CLRRuntimeHost.

riid
[in] IID dari antarmuka yang Anda minta. Nilai yang didukung adalah IID_ICorRuntimeHost atau IID_ICLRRuntimeHost.

ppv
[out] Penunjuk antarmuka ke versi runtime yang dimuat.

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: MSCorEE.idl

Pustaka: MSCorEE.dll

Versi .NET Framework: Tersedia mulai dari 1.0

Lihat juga