SWbemLastError. CompareTo, _ méthode

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

Pour une explication de cette syntaxe, consultez conventions de document pour l’API de script.

Syntaxe

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

Paramètres

objwbemObject [ dans]

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

IFlags [ dans, facultatif]

Entier qui spécifie des indicateurs supplémentaires pour l’opération. Ce paramètre spécifie les caractéristiques d’objet à prendre en compte lorsque les comparaisons d’objets sont effectuées. Vous pouvez utiliser wbemComparisonFlagIncludeAll pour prendre en compte toutes les fonctionnalités (par défaut) ou n’importe quelle combinaison des valeurs suivantes.

wbemComparisonFlagIncludeAll * * * * (0 (0x0))

Fait en sorte que toutes les propriétés, qualificateurs et versions soient comparés.

wbemComparisonFlagIgnoreQualifiers * * * * (1 (0x1))

Fait en sorte que tous les qualificateurs (y compris la clé et le dynamique) soient ignorés en comparaison.

wbemComparisonFlagIgnoreObjectSource * * * * (2 (0X2))

Fait en sorte que la source des objets, à savoir le serveur et l’espace de noms dont ils proviennent, soit ignorée par rapport aux autres objets.

wbemComparisonFlagIgnoreDefaultValues * * * * (4 (0x4))

Entraîne l’ignorance des valeurs par défaut des propriétés. Cet indicateur est significatif uniquement lors de la comparaison de classes.

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 ne compare que 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.

wbemComparisonFlagIgnoreCase * * * * (16 (0x10))

Fait en sorte que les valeurs de chaîne soient comparées sans respect de la casse. Cela s’applique à la fois 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.

wbemComparisonFlagIgnoreFlavor * * * * (32 (0x20))

Fait en sorte que les versions de qualificateur soient ignorées. 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.

Valeur de retour

La méthode _ CompareTo retourne la valeur booléenne true si les objets correspondent ; sinon, elle retourne false.

Codes d’erreur

À la fin de la méthode _ CompareTo , l’objet Err peut contenir l’un des codes d’erreur répertoriés dans 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)

Mémoire insuffisante pour terminer l’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 _ SWbemLastError
IID
IID _ ISWbemLastError

Voir aussi

SWbemLastError

M