Partager via

Fonction CompareAssemblyIdentityWithConfig

  • Article

Compare deux identités d'assembly pour déterminer si elles sont équivalentes après l'application des éléments de stratégie de portabilité à partir d'un fichier de configuration spécifié.

STDAPI CompareAssemblyIdentityWithConfig (
    [in]  LPCWSTR                  pwzAssemblyIdentity1,
    [in]  BOOL                     fUnified1,
    [in]  LPCWSTR                  pwzAssemblyIdentity2,
    [in]  BOOL                     fUnified2,
    [in]  struct AssemblyConfig    *pAssemblyConfig,
    [out] BOOL                     *pfEquivalent,
    [out] AssemblyComparisonResult *pResult
 );

Paramètres

  • pwzAssemblyIdentity1
    [in] Identité textuelle du premier assembly de la comparaison.

  • fUnified1
    [in] Indicateur booléen qui indique l'unification spécifiée par l'utilisateur pour pwzAssemblyIdentity1.

  • pwzAssemblyIdentity2
    [in] Identité textuelle du second assembly de la comparaison.

  • fUnified2
    [in] Indicateur booléen qui indique l'unification spécifiée par l'utilisateur pour pwzAssemblyIdentity2.

  • pAssemblyConfig
    [in] Fichier de configuration qui contient les informations qui affectent la stratégie de portabilité, telle que l'élément <supportPortability> ee663090(v=vs.100).md.

  • pfEquivalent
    [out] Indicateur booléen qui indique si les deux assemblys sont équivalents.

  • pResult
    [out] Valeur AssemblyComparisonResult qui contient des informations détaillées sur la comparaison.

Valeur de retour

pfEquivalent retourne une valeur Boolean qui indique si les deux assemblys sont équivalents. pResult retourne l'une des valeurs AssemblyComparisonResult, pour donner une raison plus détaillée de la valeur de pfEquivalent.

Notes

CompareAssemblyIdentityWithConfig vérifie si pwzAssemblyIdentity1 et pwzAssemblyIdentity2 sont équivalents. pfEquivalent est défini sur true si une ou plusieurs des conditions suivantes soient vraies après l'application de n'importe quel élément dans pAssemblyConfig qui affecte la stratégie de portabilité :

  • Les identités des deux assemblys sont équivalentes. Pour les assemblys à nom fort, l'équivalence implique que le nom, la version, le jeton de clé publique et la culture des assemblys soient identiques. Pour les assemblys à nom simple, l'équivalence implique une correspondance du nom et de la culture de l'assembly.

  • Les deux identités d'assembly font référence aux assemblys qui s'exécutent sur le .NET Framework. Cette condition retourne true même si les numéros de version des assemblys ne correspondent pas.

  • Les deux assemblys ne sont pas des assemblys managés, mais fUnified1 ou fUnified2 a été défini à true.

L'indicateur fUnified indique que tous les numéros de versions jusqu'au numéro de l'assembly à nom fort sont considérés comme étant équivalents à l'assembly à nom fort. Par exemple, si la valeur de pwzAssemblyIndentity1 est « MonAssembly, version=3 .0.0.0, culture=neutral, publicKeyToken=.... » et si la valeur de fUnified1 est true, cela indique que toutes les versions de MonAssembly de 0.0.0.0 à 3.0.0.0 doivent être traitées comme étant équivalentes. Dans ce cas, si pwzAssemblyIndentity2 fait référence au même assembly que pwzAssemblyIndentity1, mais porte un numéro de version inférieur, pfEquivalent a la valeur true. Si pwzAssemblyIdentity2 fait référence à un numéro de version supérieur, pfEquivalent a la valeur true uniquement si la valeur de fUnified2 est true.

Le paramètre pResult inclut des informations spécifiques à propos des raisons pour lesquelles les deux assemblys sont considérés comme équivalents ou pas. Pour plus d'informations, consultez AssemblyComparisonResult enumeration.

Configuration requise

Plateformes : consultez Configuration requise du .NET Framework.

En-tête : Fusion.h

Bibliothèque : incluse en tant que ressource dans MsCorEE.dll

Versions du .NET Framework : 4

Voir aussi

Référence

AssemblyComparisonResult, énumération

Shfusion.dll (visionneuse du cache d'assembly)

CompareAssemblyIdentity, fonction

Autres ressources

Fonctions statiques globales de la fusion

Historique des modifications

Date

Historique

Motif

Mai 2011

A corrigé des erreurs dans la documentation d'origine.

Commentaires client.

Mars 2011

A ajouté la documentation manquante de l'API.

Résolution des bogues de contenu.