IWbemClassObject ::CompareTo, méthode (wbemcli.h)
La méthode IWbemClassObject ::CompareTo compare un objet à un autre objet Windows Management. Notez que ce processus de comparaison comporte certaines contraintes.
Syntaxe
HRESULT CompareTo(
[in] long lFlags,
[in] IWbemClassObject *pCompareTo
);
Paramètres
[in] lFlags
Spécifie les caractéristiques de l’objet à prendre en compte par rapport à un autre objet. Il peut être WBEM_COMPARISON_INCLUDE_ALL de prendre en compte toutes les fonctionnalités ou toute combinaison de ces indicateurs.
WBEM_FLAG_IGNORE_OBJECT_SOURCE
Ignorez la source des objets, à savoir le serveur et l’espace de noms dont ils proviennent, par rapport à d’autres objets.
WBEM_FLAG_IGNORE_QUALIFIERS
Ignorez tous les qualificateurs (y compris key et dynamic) en comparaison.
WBEM_FLAG_IGNORE_DEFAULT_VALUES
Ignorer les valeurs par défaut des propriétés. Cette valeur n'est significative que pour la comparaison de classes.
WBEM_FLAG_IGNORE_FLAVOR
Ignorer les types de qualificateurs. Cet indicateur prend toujours en compte les valeurs de qualificateur, mais ignore les distinctions de saveur telles que les règles de propagation et les restrictions de remplacement (pour plus d’informations, consultez Saveurs de qualificateur).
WBEM_FLAG_IGNORE_CASE
Comparez les valeurs de chaîne de manière non sensible à la casse. Il s'applique aux chaînes et aux valeurs de qualificateur. Les noms de propriétés et de qualificateurs sont toujours comparés sans distinction minuscules/majuscules, que cet indicateur soit spécifié ou non.
WBEM_FLAG_IGNORE_CLASS
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 cet indicateur pour optimiser les performances. Si les objets ne sont pas de la même classe, les résultats sont non définis.
[in] pCompareTo
Objet en comparaison. Ce pointeur doit pointer vers un instance IWbemClassObject valide. Elle ne peut pas être NULL.
Valeur retournée
Cette méthode retourne une valeur HRESULT qui indique le statut de l'appel de méthode. La liste suivante répertorie la valeur contenue dans un HRESULT. Pour connaître les valeurs HRESULT générales, consultez Codes d’erreur système.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | wbemcli.h (include Wbemidl.h) |
| Bibliothèque | WbemUuid.lib |
| DLL | CIMWin32.dll ; Esscli.dll ; Fastprox.dll ; FrameDyn.dll ; FrameDynOS.dll ; Krnlprov.dll ; Ncprov.dll ; Wbemcore.dll ; Wbemess.dll ; Wmipiprt.dll |