Partager via

CompareTo, fonction

  • Article

Compare un objet à un autre objet WMI.

Notes

Cette API est destinée à un usage interne uniquement. Elle n’est pas destinée à être utilisée dans le code du développeur.

Syntaxe

HRESULT CompareTo (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LONG              flags,
   [in] IWbemClassObject* pCompareTo
);

Paramètres

vFunc
[in] Ce paramètre est inutilisé.

ptr
[in] Pointeur vers une instance IWbemClassObject.

flags
[in] Combinaison au niveau du bit des indicateurs qui spécifient les caractéristiques de l’objet à prendre en compte pour la comparaison. Pour plus d'informations, consultez la section Remarques.

pCompareTo
[in] Objet pour la comparaison. pCompareTo doit correspondre à une instance IWbemClassObject valide et ne peut pas être null.

Valeur retournée

Les valeurs suivantes renvoyées par cette fonction sont définies dans le fichier d’en-tête WbemCli.h, ou vous pouvez les définir comme constantes dans votre code :

Constant Valeur Description
WBEM_E_FAILED 0x80041001 Une erreur inconnue s’est produite.
WBEM_E_INVALID_PARAMETER 0x80041008 Un paramètre n'est pas valide.
WBEM_E_UNEXPECTED 0x8004101d Un deuxième appel à BeginEnumeration a été effectué sans appel intermédiaire à EndEnumeration.
WBEM_S_NO_ERROR 0 L’appel de fonction a réussi.
WBEM_S_DIFFERENT 0x40003 Les objets sont différents.
WBEM_S_SAME 0 Les objets sont identiques en fonction des indicateurs de comparaison.

Notes

Cette fonction encapsule un appel à la méthode IWbemClassObject::CompareTo.

Les indicateurs qui peuvent être passés en tant qu’argument lEnumFlags sont définis dans l’argument WbemCli.h, ou vous pouvez les définir en tant que constantes dans votre code. Vous pouvez spécifier les caractéristiques individuelles impliquées dans la comparaison en spécifiant une combinaison au niveau du bit des indicateurs suivants :

Constant Valeur Description
WBEM_FLAG_IGNORE_OBJECT_SOURCE 2 Ignorer la source (serveur et espace de noms d’origine).
WBEM_FLAG_IGNORE_QUALIFIERS 1 Ignorer tous les qualificateurs (y compris Clé et Dynamique)
WBEM_FLAG_IGNORE_DEFAULT_VALUES 4 Ignorer les valeurs par défaut des propriétés. Cet indicateur s’applique uniquement à la comparaison des classes.
WBEM_FLAG_IGNORE_FLAVOR 0x20 Ignorer les types de qualificateurs. Cet indicateur tient compte des qualificateurs, mais ignore les distinctions de version telles que les règles de propagation et les restrictions de substitution.
WBEM_FLAG_IGNORE_CASE 0x10 Ignorer la casse lors de la comparaison des valeurs de chaîne. Cela s'applique aux chaînes et aux valeurs de qualificateur. La comparaison des noms de propriétés et de qualificateurs respecte toujours la casse, que cet indicateur soit activé ou non.
WBEM_FLAG_IGNORE_CLASS 0x8 Suppose que les objets comparés sont des instances de la même classe. Par conséquent, cet indicateur compare uniquement les informations relatives à l’instance. Utilisez ces indicateurs pour optimiser les performances. Si les objets ne sont pas de la même classe, les résultats sont non définis.

Vous pouvez également spécifier un seul indicateur composite comme suit :

Constant Valeur Description
WBEM_COMPARISON_INCLUDE_ALL 0 Prendre en compte toutes les fonctionnalités de la comparaison.

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : WMINet_Utils.idl

Versions de .NET Framework : disponibles depuis la version 4.7.2

Voir aussi