Bagikan melalui

Fungsi LockClrVersion

Memungkinkan host untuk menentukan versi runtime bahasa umum (CLR) mana yang akan digunakan dalam proses sebelum menginisialisasi CLR secara eksplisit.

Fungsi ini tidak digunakan lagi di .NET Framework 4.

Sintaks

HRESULT LockClrVersion (  
    [in] FLockClrVersionCallback   hostCallback,  
    [in] FLockClrVersionCallback  *pBeginHostSetup,  
    [in] FLockClrVersionCallback  *pEndHostSetup  
);

Parameter

hostCallback
[in] Fungsi yang akan dipanggil oleh CLR setelah inisialisasi.

pBeginHostSetup
[in] Fungsi yang akan dipanggil oleh host untuk memberi tahu CLR bahwa inisialisasi dimulai.

pEndHostSetup
[in] Fungsi yang akan dipanggil oleh host untuk memberi tahu CLR bahwa inisialisasi selesai.

Tampilkan Nilai

Metode ini mengembalikan kode kesalahan COM standar, seperti yang ditentukan dalam WinError.h, selain nilai berikut.

Mengembalikan kode Deskripsi
S_OK Metode berhasil diselesaikan.
E_INVALIDARG Satu atau beberapa argumen adalah null.

Keterangan

Host memanggil LockClrVersion sebelum menginisialisasi CLR. LockClrVersion mengambil tiga parameter, yang semuanya merupakan panggilan balik jenis FLockClrVersionCallback. Tipe ini didefinisikan sebagai berikut.

typedef HRESULT ( __stdcall *FLockClrVersionCallback ) ();

Langkah-langkah berikut terjadi pada inisialisasi runtime:

  1. Host memanggil CorBindToRuntimeEx atau salah satu fungsi inisialisasi runtime lainnya. Atau, host dapat menginisialisasi runtime menggunakan aktivasi objek COM.

  2. Runtime memanggil fungsi yang ditentukan oleh parameter hostCallback.

  3. Fungsi yang ditentukan oleh hostCallback kemudian membuat urutan panggilan berikut:

Semua panggilan dari pBeginHostSetup ke pEndHostSetup harus terjadi pada satu utas atau fiber, dengan tumpukan logis yang sama. Utas ini bisa berbeda dari utas tempat hostCallback dipanggil.

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: MSCorEE.h

Pustaka: MSCorEE.dll

Versi .NET Framework: Tersedia mulai dari 2.0

Lihat juga

  • Last updated on