SWbemLastError.CompareTo_-Methode

Die CompareTo\_-Methode des SWbemLastError-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 Skript-API.

Syntax

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

Parameter

objwbemObject [in]

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

iFlags [in, optional]

Eine ganze Zahl, die zusätzliche Flags für den Vorgang angibt. Dieser Parameter gibt die Objektmerkmale an, die bei Objektvergleichen berücksichtigt werden sollen. Sie können wbemComparisonFlagIncludeAll verwenden, um alle Features (Standard) oder eine beliebige Kombination der folgenden Werte zu berücksichtigen.

wbemComparisonFlagIncludeAll (0 (0x0))

Bewirkt, dass alle Eigenschaften, Qualifizierer und Varianten verglichen werden.

wbemComparisonFlagIgnoreQualifiers (1 (0x1))

Bewirkt, dass alle Qualifizierer (einschließlich Key und Dynamic) beim Vergleich ignoriert werden.

wbemComparisonFlagIgnoreObjectSource (2 (0x2))

Bewirkt, dass die Quelle der Objekte, d. h. der Server und Namespace, aus dem sie stammen, beim Vergleich mit anderen Objekten ignoriert wird.

wbemComparisonFlagIgnoreDefaultValues (4 (0x4))

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

wbemComparisonFlagIgnoreClass (8 (0x8))

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

wbemComparisonFlagIgnoreCase (16 (0x10))

Bewirkt, dass Zeichenfolgenwerte ohne Beachtung der Groß-/Kleinschreibung verglichen werden. 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.

wbemComparisonFlagIgnoreFlavor (32 (0x20))

Bewirkt, dass Qualifizierervarianten ignoriert werden. Dieses Flag berücksichtigt Qualifiziererwerte, ignoriert jedoch Unterschiede bei den verschiedenen Typen, z. B. Weitergaberegeln und Einschränkungen beim Überschreiben.

Rückgabewert

Die CompareTo_-Methode gibt den booleschen Wert TRUE zurück, wenn die Objekte übereinstimmen. Andernfalls wird FALSE zurückgegeben.

Fehlercodes

Nach Abschluss der CompareTo_-Methode enthält das Err-Objekt möglicherweise einen der Fehlercodes aus der folgenden Liste.

wbemErrFailed – 2147749889 (0x80041001)

Unbekannter Fehler.

wbemErrInvalidParameter – 2147749896 (0x80041008)

Ein angegebener Parameter ist ungültig.

wbemErrOutOfMemory – 2147749894 (0x80041006)

Es ist nicht genügend Arbeitsspeicher zum Abschließen des Vorgangs vorhanden.

Anforderungen

Weitere Informationen

SWbemLastError

SWbemObject