Função de CompareAssemblyIdentity

Artigo
08/08/2011

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 textual do primeiro conjunto na comparação.
fUnified1
[in] Um sinalizador booleano que indica a Unificação de usuário especificado para pwzAssemblyIdentity1.
pwzAssemblyIdentity2
[in] A identidade textual do segundo conjunto de comparação.
fUnified2
[in] Um sinalizador booleano que indica a Unificação de usuário especificado para pwzAssemblyIdentity2.
pfEquivalent
[out] Um sinalizador booleano que indica se os dois assemblies são equivalentes.
pResult
[out] Um AssemblyComparisonResult enumeração contém informações detalhadas sobre a comparação.

Valor de retorno

pfEquivalentRetorna um valor booleano que indica se os dois assemblies são equivalentes. pResultRetorna um da AssemblyComparisonResult valores, para dar um motivo mais detalhado para o valor de pfEquivalent.

Comentários

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

As identidades de duas assembly são equivalentes. Para módulos fortemente nomeados, a equivalência requer o nome do assembly, versão, token de chave pública e cultura a ser idênticos. Para simplesmente nomeados assemblies, equivalência requer uma correspondência no nome do assembly e cultura.
Ambas as identidades de assembly consultem assemblies executados no.NET Framework. Essa condição retornará true , mesmo se os números de versão do assembly não coincidem.
Os dois assemblies não são assemblies gerenciados, mas fUnified1 ou fUnified2 foi definido como true.

O fUnified Sinalizador que 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, culture = neutral, publicKeyToken =...." e o valor de fUnified1 é true, isso indica que todas as versões do MyAssembly da versão 0.0.0.0 para 3.0.0.0 devem ser tratadas como equivalente. Nesse caso, se pwzAssemblyIndentity2 refere-se ao mesmo assembly como pwzAssemblyIndentity1, exceto que ele tem um número de versão menor, pfEquivalent for definido como true. Se pwzAssemblyIdentity2 se refere a um número de versão superior, pfEquivalent for definido como true somente se o valor de fUnified2 é true.

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

Chamar essa função é a mesma chamada a CompareAssembyIdentityWithConfig de função e passar NULL o pAssemblyConfig parâmetro.