Méthode SWbemObject.CompareTo_

La méthode CompareTo_ de l’objet SWbemObject compare deux objets SWbemObject. Cette comparaison est soumise à certaines contraintes basées sur les valeurs spécifiées dans le paramètre iFlags.

Pour obtenir une explication de cette syntaxe, consultez Conventions de document pour l’API Scripting.

Syntaxe

bAreEqual = .CompareTo_( _
  ByVal objwbemObject, _
  [ ByVal iFlags ] _
)

Paramètres

objwbemObject [in]

Obligatoire. Ce paramètre est un objet SWbemObject . Il s’agit de l’objet avec lequel le premier objet est comparé. L’objet doit être une instance SWbemObject valide.

iFlags [in, facultatif]

Spécifie les caractéristiques de l’objet à prendre en compte lors de la comparaison d’un objet avec d’autres. Vous pouvez utiliser wbemComparisonFlagIncludeAll pour prendre en compte toutes les fonctionnalités (il s’agit de la valeur par défaut), ou toute combinaison des valeurs suivantes.

wbemComparisonFlagIncludeAll (0 (0x0))

Compare toutes les propriétés, qualificateurs et variantes.

wbemComparisonFlagIgnoreObjectSource (2 (0x2))

Mode ignorant la source des objets, c'est-à-dire le serveur et l'espace de noms d'où ils proviennent, dans la comparaison avec d'autres objets.

wbemComparisonFlagIgnoreQualifiers (1 (0x1))

Fait que tous les qualificateurs (y compris Key et Dynamic) sont ignorés en comparaison.

wbemComparisonFlagIgnoreDefaultValues (4 (0x4))

Fait en sorte que les valeurs par défaut des propriétés soient ignorées. Cette valeur n'est significative que pour la comparaison de classes.

wbemComparisonFlagIgnoreFlavor (32 (0x20))

Fait en sorte d’ignorer les variantes de qualificateurs. Cet indicateur tient compte des valeurs de qualificateur, mais ignore les distinctions de version telles que les règles de propagation et les restrictions de substitution.

wbemComparisonFlagIgnoreCase (16 (0x10))

Mode comparant les valeurs de chaîne sans distinction minuscules/majuscules. Il s'applique aux chaînes et aux valeurs de qualificateurs. 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.

wbemComparisonFlagIgnoreClass (8 (0x8))

Indique au système de supposer 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.

Valeur retournée

Cette méthode retourne la valeur booléenne VRAI si les objets correspondent. Elle retourne FAUX si les objets ne correspondent pas.

Codes d’erreur

Une fois la méthode CompareTo_ terminée, l’objet Err peut contenir l’un des codes d’erreur de la liste suivante.

wbemErrFailed - 2147749889 (0x80041001)

Erreur non spécifiée.

wbemErrInvalidParameter - 2147749896 (0x80041008)

Un paramètre spécifié n’est pas valide.

wbemErrOutOfMemory - 2147749894 (0x80041006)

La mémoire disponible est insuffisante pour terminer cette opération.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
En-tête	Wbemdisp.h
Bibliothèque de types	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemObject
IID	IID_ISWbemObject

Voir aussi

SWbemObject