CompareAssemblyIdentity – funkce

Článek
05/10/2023

Porovná dvě identity sestavení a určí, jestli jsou ekvivalentní.

Syntaxe

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

Parametry

pwzAssemblyIdentity1
[v] Textová identita prvního sestavení v porovnání.

fUnified1
[v] Logický příznak označující sjednocení zadané uživatelem pro pwzAssemblyIdentity1.

pwzAssemblyIdentity2
[v] Textová identita druhého sestavení v porovnání.

fUnified2
[v] Logický příznak označující sjednocení zadané uživatelem pro pwzAssemblyIdentity2.

pfEquivalent
[out] Logický příznak, který označuje, zda jsou obě sestavení ekvivalentní.

pResult
[out] Výčet AssemblyComparisonResult , který obsahuje podrobné informace o porovnání.

Návratová hodnota

pfEquivalent vrátí logickou hodnotu, která označuje, zda jsou obě sestavení ekvivalentní. pResult vrátí jednu z AssemblyComparisonResult hodnot, aby bylo možné uvést podrobnější důvod pro hodnotu pfEquivalent.

Poznámky

CompareAssemblyIdentity zkontroluje, zda pwzAssemblyIdentity1 a pwzAssemblyIdentity2 jsou ekvivalentní. pfEquivalent je nastavená na true hodnotu za jedné nebo několika následujících podmínek:

Obě identity sestavení jsou ekvivalentní. U sestavení se silným názvem vyžaduje ekvivalence stejný název sestavení, verzi, token veřejného klíče a jazykovou verzi. U jednoduchých pojmenovaných sestavení vyžaduje ekvivalence shodu názvu a jazykové verze sestavení.
Obě identity sestavení odkazují na sestavení, která běží v rozhraní .NET Framework. Tato podmínka se vrátí true i v případě, že se čísla verzí sestavení neshodují.
Tato dvě sestavení nejsou spravovaná sestavení, ale fUnified1 byla fUnified2 nastavena na truehodnotu .

Příznak fUnified označuje, že všechna čísla verzí až do čísla verze sestavení se silným názvem jsou považována za ekvivalentní sestavení se silným názvem. Pokud je například hodnota pwzAssemblyIdentity1 "MyAssembly, version=3.0.0.0, culture=neutral, publicKeyToken=...." a hodnota fUnified1 je true, znamená to, že všechny verze MyAssembly z verze 0.0.0.0 do 3.0.0.0 by měly být považovány za ekvivalentní. V takovém případě, pokud pwzAssemblyIdentity2 odkazuje na stejné sestavení jako pwzAssemblyIdentity1, s výjimkou, že má nižší číslo verze, pfEquivalent je nastaven na true. Pokud pwzAssemblyIdentity2 odkazuje na vyšší číslo verze, je nastaven na true pouze v případě, pfEquivalent že hodnota je fUnified2true.

Parametr pResult obsahuje konkrétní informace o tom, proč jsou dvě sestavení považována za ekvivalentní nebo ne ekvivalentní. Další informace najdete v tématu AssemblyComparisonResult – výčet.

Požadavky

Platformy: Viz Požadavky na systém.

Záhlaví: Fusion.h

Knihovny: Zahrnuto jako prostředek v MsCorEE.dll

Verze rozhraní .NET Framework: K dispozici od verze 2.0

Sdílet prostřednictvím