Méthode SWbemLastError.CompareTo_

Article
06/29/2023

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 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. Un objet de classe SWbemObject. Ce paramètre est l’objet avec lequel le premier objet est comparé. L'objet doit être une instance valide de SWbemObject.
iFlags [in, facultatif]: Un entier qui spécifie des indicateurs supplémentaires pour l’opération. Ce paramètre spécifie les caractéristiques de l’objet à prendre en compte lorsque des comparaisons d’objets sont effectuées. Vous pouvez utiliser wbemComparisonFlagIncludeAll pour prendre en compte toutes les fonctionnalités (valeur par défaut), ou toute combinaison des valeurs suivantes.
wbemComparisonFlagIncludeAll (0 (0x0)): Provoque la comparaison de toutes les propriétés, qualificateurs et types.
wbemComparisonFlagIgnoreQualifiers (1 (0x1)): Fait que tous les qualificateurs (y compris Key et Dynamic) sont ignorés en comparaison.
wbemComparisonFlagIgnoreObjectSource (2 (0x2)): La source des objets, à savoir le serveur et l'espace de noms dont ils proviennent, est ignorée par rapport à d'autres objets.
wbemComparisonFlagIgnoreDefaultValues (4 (0x4)): Les valeurs par défaut des propriétés sont ignorées. Cette valeur n'est significative que pour 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 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.
wbemComparisonFlagIgnoreCase (16 (0x10)): Permet de comparer les valeurs des chaînes de caractères sans tenir compte de 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.
wbemComparisonFlagIgnoreFlavor (32 (0x20)): Les types des qualificateurs sont 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 retournée

La méthode CompareTo_ retourne la valeur booléenne TRUE si les objets correspondent ; sinon, elle retourne FALSE.

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_SWbemLastError
IID	IID_ISWbemLastError

Voir aussi

SWbemLastError
SWbemObject

Partager via