Udostępnij za pośrednictwem

CompareAssemblyIdentity — Funkcja

  • Artykuł

Porównuje dwie tożsamości zestawów, aby określić, czy są równoważne.

Składnia

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

Parametry

pwzAssemblyIdentity1
[in] Tekstowa tożsamość pierwszego zestawu w porównaniu.

fUnified1
[in] Flaga logiczna wskazująca zjednoczenie określone przez użytkownika dla elementu pwzAssemblyIdentity1.

pwzAssemblyIdentity2
[in] Tekstowa tożsamość drugiego zestawu w porównaniu.

fUnified2
[in] Flaga logiczna wskazująca zjednoczenie określone przez użytkownika dla elementu pwzAssemblyIdentity2.

pfEquivalent
[out] Flaga logiczna wskazująca, czy dwa zestawy są równoważne.

pResult
[out] Wyliczenie AssemblyComparisonResult zawierające szczegółowe informacje na temat porównania.

Wartość zwracana

pfEquivalent Zwraca wartość logiczną wskazującą, czy dwa zestawy są równoważne. pResult Zwraca jedną z AssemblyComparisonResult wartości, aby podać bardziej szczegółowy powód wartości pfEquivalent.

Uwagi

CompareAssemblyIdentity sprawdza, czy pwzAssemblyIdentity1 i pwzAssemblyIdentity2 są równoważne. pfEquivalent parametr jest ustawiony na true co najmniej jeden z następujących warunków:

  • Dwie tożsamości zestawów są równoważne. W przypadku zestawów silnie nazwanych równoważność wymaga identycznej nazwy zestawu, wersji, tokenu klucza publicznego i kultury. W przypadku po prostu nazwanych zestawów równoważność wymaga dopasowania nazwy zestawu i kultury.

  • Obie tożsamości zestawów odwołują się do zestawów uruchamianych na .NET Framework. Ten warunek jest zwracany true nawet wtedy, gdy numery wersji zestawu nie są zgodne.

  • Dwa zestawy nie są zarządzanymi zestawami, ale fUnified1fUnified2 zostały ustawione na truewartość .

Flaga fUnified wskazuje, że wszystkie numery wersji do numeru wersji silnie nazwanego zestawu są uważane za równoważne silnie nazwanym zestawowi. Jeśli na przykład wartość pwzAssemblyIdentity1 to "MyAssembly, version=3.0.0.0, culture=neutral, publicKeyToken=....", a wartość parametru fUnified1 to true, oznacza to, że wszystkie wersje zestawu MyAssembly z wersji 0.0.0.0.0 do 3.0.0.0 powinny być traktowane jako równoważne. W takim przypadku, jeśli pwzAssemblyIdentity2 odnosi się do tego samego zestawu co pwzAssemblyIdentity1, z tą różnicą, że ma niższy numer wersji, pfEquivalent jest ustawiony na truewartość . Jeśli pwzAssemblyIdentity2 odwołuje się do wyższego numeru wersji, jest ustawiony true tylko wtedy, pfEquivalent gdy wartość fUnified2 to true.

Parametr pResult zawiera określone informacje o tym, dlaczego oba zestawy są uważane za równoważne lub nie równoważne. Aby uzyskać więcej informacji, zobacz AssemblyComparisonResult, wyliczenie.

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: Fusion.h

Biblioteki: Uwzględnione jako zasób w MsCorEE.dll

wersje .NET Framework: dostępne od wersji 2.0

Zobacz też