IWbemClassObject::CompareTo-Methode (wbemcli.h)

  • Artikel

Die IWbemClassObject::CompareTo-Methode vergleicht ein Objekt mit einem anderen Windows-Verwaltungsobjekt. Beachten Sie, dass dieser Vergleichsprozess bestimmte Einschränkungen aufweist.

Syntax

HRESULT CompareTo(
  [in] long             lFlags,
  [in] IWbemClassObject *pCompareTo
);

Parameter

[in] lFlags

Gibt die Objektmerkmale an, die im Vergleich zu einem anderen Objekt berücksichtigt werden sollen. Es kann WBEM_COMPARISON_INCLUDE_ALL sein, alle Features oder eine beliebige Kombination dieser Flags zu berücksichtigen.

WBEM_FLAG_IGNORE_OBJECT_SOURCE

Ignorieren Sie die Quelle der Objekte, d. h. den Server und den Namespace, aus dem sie stammen, im Vergleich zu anderen Objekten.

WBEM_FLAG_IGNORE_QUALIFIERS

Ignorieren Sie im Vergleich alle Qualifizierer (einschließlich Key und Dynamic).

WBEM_FLAG_IGNORE_DEFAULT_VALUES

Ignoriert die Standardwerte von Eigenschaften. Dieses Flag ist nur beim Vergleichen von Klassen sinnvoll.

WBEM_FLAG_IGNORE_FLAVOR

Ignoriert Qualifizierertypen. Dieses Flag berücksichtigt weiterhin Qualifiziererwerte, ignoriert jedoch Unterscheidungen von Geschmacksrichtungen wie Weitergaberegeln und Außerkraftsetzungseinschränkungen (weitere Informationen finden Sie unter Qualifiziereraromen).

WBEM_FLAG_IGNORE_CASE

Vergleichen Sie Zeichenfolgenwerte ohne Berücksichtigung 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.

WBEM_FLAG_IGNORE_CLASS

Es wird vorausgesetzt, dass es sich bei den zu vergleichenden 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.

[in] pCompareTo

Objekt im Vergleich. Dieser Zeiger muss auf eine gültige IWbemClassObject-instance zeigen. Es darf nicht NULL sein.

Rückgabewert

Diese Methode gibt ein HRESULT zurück, das den Status des Methodenaufrufs angibt. In der folgenden Liste ist der in einem HRESULT enthaltene Wert aufgeführt. Allgemeine HRESULT-Werte finden Sie unter Systemfehlercodes.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile wbemcli.h (include Wbemidl.h)
Bibliothek WbemUuid.lib
DLL CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll

Weitere Informationen

IWbemClassObject

Qualifizierervarianten

WBEM_COMPARISON_FLAG