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 Skript-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 Objekteigenschaften an, die beim Vergleich eines Objekts mit anderen Objekten 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))

Vergleicht alle Eigenschaften, Qualifizierer und Varianten.

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.

wbemComparisonFlagIgnoreQualifiers (1 (0x1))

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

wbemComparisonFlagIgnoreDefaultValues (4 (0x4))

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

wbemComparisonFlagIgnoreFlavor (32 (0x20))

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

wbemComparisonFlagIgnoreCase (16 (0x10))

Vergleicht Zeichenfolgenwerte ohne Berücksichtigung von Groß- und 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. 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.

Rückgabewert

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

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

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