Função CompareAssemblyIdentity

Artigo
08/25/2010

Compara duas identidades de assembly para determinar se são equivalentes.

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

Parâmetros

pwzAssemblyIdentity1
[in] A identidade do assembly primeiro na comparação textual.
fUnified1
[in] Um sinalizar booliano que indica a Unificação especificado pelo usuário para pwzAssemblyIdentity1.
pwzAssemblyIdentity2
[in] A identidade do segundo assembly na comparação textual.
fUnified2
[in] Um sinalizar booliano que indica a Unificação especificado pelo usuário para pwzAssemblyIdentity2.
pfEquivalent
[out] Um sinalizar booliano que indica se os dois assemblies são equivalentes.
pResult
[out] An AssemblyComparisonResultenumeração de contém informações detalhadas sobre a comparação.

Valor de retorno

pfEquivalent Retorna um valor booliano que indica se os dois assemblies são equivalentes. pResult Retorna um do AssemblyComparisonResult valores, para fornecer um motivo mais detalhado para o valor de pfEquivalent.

Comentários

CompareAssemblyIdentity verifica se pwzAssemblyIdentity1 e pwzAssemblyIdentity2 são equivalentes. pfEquivalent é definido como true em uma ou mais das seguintes condições:

As identidades de duas assembly são equivalentes. Para assemblies fortemente nomeados, equivalência requer o nome do assembly, versão, token de chave pública e cultura seja idêntico. Para simplesmente nomeados assemblies, equivalência requer uma correspondência no nome do assembly e cultura.
Ambas as identidades de assembly consultem assemblies que são executados no WinFX. Essa condição retornará true mesmo se os números da versão do assembly não forem correspondentes.
Os dois assemblies não são assemblies gerenciado, mas fUnified1 ou fUnified2 foi conjunto para true.

The fUnified sinalizar indica que todos os números de versão até o número de versão do assembly fortemente nomeado são considerados equivalentes ao assembly fortemente nomeado. Por exemplo, se o valor de pwzAssemblyIndentity1é "MyAssembly, versão = 3.0.0.0, cultura = neutral, publicKeyToken =...." e o valor de fUnified1 é true, isso indica que todas sistema autônomo versões do MyAssembly de 0.0.0.0 para 3.0.0.0 versão devem ser tratadas sistema autônomo equivalente. Nesse caso, se pwzAssemblyIndentity2 refere-se ao mesmo assembly sistema autônomo pwzAssemblyIndentity1, exceto que ele tenha um número de versão menor pfEquivalent é conjunto para true. If pwzAssemblyIdentity2 refere-se a um número de versão maior pfEquivalent é conjunto para true somente se o valor de fUnified2 é true.

The pResult parâmetro inclui informações específicas sobre por que dois assemblies são considerados não equivalente ou equivalente. Para obter mais informações, consulte Enumeração AssemblyComparisonResult.