SWbemObject.CompareTo-Methode _

Die CompareTo-Methode _ des SWbemObject-Objekts vergleicht zwei SWbemObject-Objekte. Dieser Vergleich unterliegt bestimmten Einschränkungen, die auf den im iFlags-Parameter angegebenen Werten basieren.

Eine Erläuterung dieser Syntax finden Sie unter Dokumentkonventionen für die Skripterstellungs-API.

Syntax

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

Parameter

objwbemObject [ In]

Erforderlich. Dieser Parameter ist ein SWbemObject-Objekt. Dies ist das Objekt, mit dem das erste Objekt verglichen wird. Das Objekt muss eine gültige SWbemObject-Instanz sein.

iFlags [ in, optional]

Gibt die Objektmerkmale an, die beim Vergleichen eines Objekts mit anderen Objekten berücksichtigt werden sollen. Sie können wbemComparisonFlagIncludeAll verwenden, um alle Features (dies ist die Standardeinstellung) oder eine beliebige Kombination der folgenden Werte zu berücksichtigen.

wbemComparisonFlagIncludeAll** (0 (0x0))

Vergleicht alle Eigenschaften, Qualifizierer und Varianten.

wbemComparisonFlagIgnoreObjectSource** (2 (0x2))

Bewirkt, dass die Quelle der Objekte, nämlich der Server und der Namespace, von dem sie stammen, im Vergleich zu anderen Objekten ignoriert werden.

wbemComparisonFlagIgnoreQualifiers" (1 (0x1))

Bewirkt, dass alle Qualifizierer (einschließlich Schlüssel und dynamischer) im Vergleich ignoriert werden.

wbemComparisonFlagIgnoreDefaultValues" (4 (0x4))

Bewirkt, dass Standardwerte von Eigenschaften ignoriert werden. Dieses Flag ist nur beim Vergleichen von Klassen sinnvoll.

wbemComparisonFlagIgnoreFlavor( (32 (0x20))

Bewirkt, dass Qualifizierer-Varianten ignoriert werden. Dieses Flag berücksichtigt Qualifiziererwerte, ignoriert jedoch Variantenunterscheidungen wie Weitergaberegeln und Außerkraftsetzungseinschränkungen.

wbemComparisonFlagIgnoreCase( (16 (0x10))

Vergleicht Zeichenfolgenwerte ohne Überschreitung der Groß-/Kleinschreibung. Dies gilt sowohl für Zeichenfolgen als auch für Qualifiziererwerte. Unabhängig davon, ob dieses Flag angegeben ist, werden Eigenschaften- und Qualifizierernamen immer ohne Berücksichtigung von Groß- und Kleinschreibung verglichen.

wbemComparisonFlagIgnoreClass( (8 (0x8))

Weist das System an, davon auszugehen, dass es sich bei den verglichenen Objekten um Instanzen derselben Klasse handelt. Folglich vergleicht dieses Flag nur instanzbezogene Informationen. Mithilfe dieses Flags können Sie die Leistung optimieren. Wenn die Objekte nicht zu derselben Klasse gehören, sind die Ergebnisse undefiniert.

Rückgabewert

Diese Methode gibt den booleschen Wert TRUE zurück, wenn die Objekte übereinstimmen. Wenn die Objekte nicht übereinstimmen, wird FALSE zurückgegeben.

Fehlercodes

Nach Abschluss der CompareTo-Methode _ kann das Err-Objekt einen der Fehlercodes in der folgenden Liste enthalten.

wbemErrFailed – 2147749889 (0x80041001)

Unbekannter Fehler.

wbemErrInvalidParameter – 2147749896 (0x80041008)

Ein angegebener Parameter ist ungültig.

wbemErrOutOfMemory – 2147749894 (0x80041006)

Nicht genügend Arbeitsspeicher, um den Vorgang abzuschließen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista
Unterstützte Mindestversion (Server)
Windows Server 2008
Header
Wbemdisp.h
Typbibliothek
Wbemdisp.tlb
DLL
Wbemdisp.dll
CLSID
CLSID _ SWbemObject
IID
IID _ ISWbemObject

Siehe auch

Swbemobject