IWbemClassObject ::CompareTo, méthode (wbemcli.h)

  • Article

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

Voir aussi

IWbemClassObject

Types de qualificateurs

WBEM_COMPARISON_FLAG