Bagikan melalui

Metode IHostAssemblyManager::GetNonHostStoreAssemblies

Mendapatkan penunjuk antarmuka ke ICLRAssemblyReferenceList yang mewakili daftar assembly yang diharapkan host untuk memuat runtime bahasa umum (CLR).

Sintaks

HRESULT GetNonHostStoreAssemblies (  
    [out] ICLRAssemblyReferenceList **ppReferenceList  
);

Parameter

ppReferenceList
[out] Penunjuk ke alamat ICLRAssemblyReferenceList yang berisi daftar referensi ke assembly yang diharapkan host untuk memuat CLR.

Tampilkan Nilai

HRESULT Deskripsi
S_OK GetNonHostStoreAssemblies berhasil dikembalikan.
HOST_E_CLRNOTAVAILABLE Runtime bahasa umum belum dimuat ke dalam proses, atau runtime bahasa umum dalam status yaitu tidak dapat menjalankan kode aman atau memproses panggilan dengan sukses.
HOST_E_TIMEOUT Waktu panggilan habis.
HOST_E_NOT_OWNER Pemanggil tidak memiliki kunci.
HOST_E_ABANDONED Peristiwa dibatalkan saat rangkaian atau fiber yang diblokir sedang menunggunya.
E_FAIL Kegagalan katastrofe yang tidak diketahui terjadi. Saat metode menampilkan E_FAIL, CLR tidak lagi dapat digunakan dalam proses. Panggilan berikutnya ke metode hosting menampilkan HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY Tidak cukup memori yang tersedia untuk membuat daftar referensi untuk ICLRAssemblyReferenceList yang diminta.

Keterangan

CLR menyelesaikan referensi menggunakan serangkaian panduan berikut:

  • Pertama, CLR melihat daftar referensi assembly yang dikembalikan oleh GetNonHostStoreAssemblies.

  • Jika assembly muncul dalam daftar, CLR mengikatnya secara normal.

  • Jika assembly tidak muncul dalam daftar dan host telah menyediakan implementasi IHostAssemblyStore, CLR memanggil IHostAssemblyStore::ProvideAssembly untuk memungkinkan host menyediakan assembly untuk diikat.

  • Jika tidak, CLR gagal mengikat assembly.

Jika host mengatur ppReferenceList ke null, CLR pertama-tama memeriksa cache assembly global, memanggil ProvideAssembly, kemudian memeriksa basis aplikasi untuk menyelesaikan referensi assembly.

Catatan

Setelah inisialisasi, CLR hanya memanggil GetNonHostStoreAssemblies sekali. Metode ini tidak dipanggil lagi.

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: MSCorEE.h

Pustaka: Disertakan sebagai sumber daya di MSCorEE.dll

Versi .NET Framework: Tersedia mulai dari 2.0

Lihat juga

  • Last updated on