IWbemClassObject::CompareTo-Methode (wbemcli.h)
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 |