Bagikan melalui

IMetaDataAssemblyImport::FindAssembliesByName Method

Mendapatkan array rakitan dengan parameter yang ditentukan szAssemblyName , menggunakan aturan standar yang digunakan oleh runtime bahasa umum (CLR) untuk menyelesaikan referensi.

Syntax

HRESULT FindAssembliesByName (
    [in]  LPCWSTR     szAppBase,
    [in]  LPCWSTR     szPrivateBin,
    [in]  LPCWSTR     szAssemblyName,
    [out] IUnknown    *ppIUnk[],
    [in]  ULONG       cMax,
    [out] ULONG       *pcAssemblies
);

Parameters

szAppBase [di] Direktori akar untuk mencari rakitan yang diberikan. Jika nilai ini diatur ke null, FindAssembliesByName hanya akan terlihat di cache perakitan global untuk perakitan.

szPrivateBin [di] Daftar subdirektori yang dibatasi titik koma (misalnya, "bin; bin2"), di bawah direktori akar, untuk mencari perakitan. Direktori ini diselimuti selain yang ditentukan dalam aturan pemeriksaan default.

szAssemblyName [di] Nama assembly yang akan ditemukan. Format string ini ditentukan di halaman referensi kelas untuk AssemblyName.

ppIUnk [out] Array yang menyimpan penunjuk IMetadataAssemblyImport antarmuka.

cMax [di] Jumlah maksimum penunjuk antarmuka untuk ditempatkan di ppIUnk.

pcAssemblies [out] Jumlah penunjuk antarmuka yang dikembalikan—yaitu, jumlah penunjuk antarmuka yang benar-benar ditempatkan di ppIUnk.

Return Value

HRESULT Description
S_OK FindAssembliesByName berhasil dikembalikan.
S_FALSE Tidak ada rakitan.

Remarks

Dengan nama assembly, FindAssembliesByName metode menemukan assembly dengan mengikuti aturan standar untuk menyelesaikan referensi assembly. (Untuk informasi selengkapnya, lihat Cara Runtime Menemukan Rakitan.) FindAssembliesByName memungkinkan pemanggil untuk mengonfigurasi berbagai aspek konteks pemecah masalah perakitan, seperti basis aplikasi dan jalur pencarian privat.

Metode ini FindAssembliesByName mengharuskan CLR untuk diinisialisasi dalam proses untuk memanggil logika resolusi perakitan. Oleh karena itu, Anda harus memanggil CoInitializeEE (melewati COINITEE_DEFAULT) sebelum memanggil FindAssembliesByName, lalu mengikuti dengan panggilan ke CoUninitializeCor.

FindAssembliesByName mengembalikan penunjuk IMetaDataImport ke file yang berisi manifes perakitan untuk nama rakitan yang diteruskan. Jika nama rakitan yang diberikan tidak sepenuhnya ditentukan (misalnya, jika tidak menyertakan versi), beberapa rakitan mungkin dikembalikan.

FindAssembliesByName umumnya digunakan oleh kompilator yang mencoba menemukan rakitan yang dirujuk pada waktu kompilasi.

Requirements

Platform: Lihat Sistem operasi yang didukung .NET.

Header: Cor.h

Library: CorGuids.lib

See also

  • Last updated on