Bagikan melalui

Fungsi CompareAssemblyIdentity

Membandingkan dua identitas perakitan untuk menentukan apakah identitas tersebut setara.

Sintaks

STDAPI CompareAssemblyIdentity (  
    [in]  LPCWSTR                  pwzAssemblyIdentity1,  
    [in]  BOOL                     fUnified1,  
    [in]  LPCWSTR                  pwzAssemblyIdentity2,  
    [in]  BOOL                     fUnified2,  
    [out] BOOL                     *pfEquivalent,  
    [out] AssemblyComparisonResult *pResult  
 );

Parameter

pwzAssemblyIdentity1
[in] Identitas tekstual dari assembly pertama dalam perbandingan.

fUnified1
[in] Bendera Boolean yang menunjukkan penyatuan yang ditentukan pengguna untuk pwzAssemblyIdentity1.

pwzAssemblyIdentity2
[in] Identitas tekstual dari assembly kedua dalam perbandingan.

fUnified2
[in] Bendera Boolean yang menunjukkan penyatuan yang ditentukan pengguna untuk pwzAssemblyIdentity2.

pfEquivalent
[out] Bendera Boolean yang menunjukkan apakah kedua assembly tersebut setara.

pResult
[out] Enumerasi AssemblyComparisonResult yang berisi informasi terperinci tentang perbandingan.

Tampilkan Nilai

pfEquivalent mengembalikan nilai Boolean yang menunjukkan apakah kedua assembly tersebut setara. pResult mengembalikan salah satu nilai AssemblyComparisonResult untuk memberikan alasan yang lebih rinci untuk nilai pfEquivalent.

Keterangan

CompareAssemblyIdentity memeriksa apakah pwzAssemblyIdentity1 dan pwzAssemblyIdentity2 setara. pfEquivalent diatur ke true di bawah satu atau beberapa kondisi berikut:

  • Kedua identitas assembly setara. Untuk assembly dengan nama yang kuat, kesetaraan memerlukan nama assembly, versi, token kunci publik, dan kultur agar identik. Untuk assembly bernama sederhana, kesetaraan membutuhkan kecocokan pada nama dan kultur assembly.

  • Kedua identitas assembly mengacu pada assembly yang berjalan pada .NET Framework. Kondisi ini mengembalikan true meskipun nomor versi assembly tidak cocok.

  • Dua assembly tersebut bukan assembly yang terkelola, tetapi fUnified1 atau fUnified2 diatur ke true.

Bendera fUnified menunjukkan bahwa semua nomor versi hingga nomor versi assembly bernama kuat dianggap setara dengan assembly yang dinamai dengan kuat. Misalnya, jika nilai pwzAssemblyIdentity1 adalah "MyAssembly, version=3.0.0.0, culture=netral, publicKeyToken=....", dan nilai fUnified1 adalah true, ini menunjukkan bahwa semua versi MyAssembly dari versi 0.0.0.0 hingga 3.0.0.0 harus diperlakukan setara. Dalam kasus seperti itu, jika pwzAssemblyIdentity2 mengacu pada perakitan yang sama dengan pwzAssemblyIdentity1, kecuali bahwa ia memiliki nomor versi yang lebih rendah, pfEquivalent diatur ke true. Jika pwzAssemblyIdentity2 merujuk ke nomor versi yang lebih tinggi, pfEquivalent diatur ke true hanya jika nilai fUnified2 adalah true.

Parameter pResult ini mencakup informasi spesifik tentang mengapa kedua assembly dianggap setara atau tidak setara. Untuk informasi selengkapnya, lihat AssemblyComparisonResult Enumeration.

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: Fusion.h

Pustaka: Disertakan sebagai sumber daya dalam MsCorEE.dll

Versi .NET Framework: Tersedia mulai dari 2.0

Lihat juga

  • Last updated on