CompareTo-Funktion

  • Artikel

Vergleicht ein Objekt mit einem anderen Windows-Verwaltungsobjekt.

Hinweis

Diese API ist ausschließlich für die interne Verwendung vorgesehen. Sie ist nicht für die Verwendung im Entwicklercode vorgesehen.

Syntax

HRESULT CompareTo (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LONG              flags,
   [in] IWbemClassObject* pCompareTo
);

Parameter

vFunc
[in] Dieser Parameter wird nicht verwendet.

ptr
[in] Ein Zeiger auf eine IWbemClassObject-Instanz

flags
[in] Eine bitweise Kombination der Flags, die die Objektmerkmale angeben, die für den Vergleich berücksichtigt werden sollen. Weitere Informationen finden Sie im Abschnitt Hinweise.

pCompareTo
[in] Das zu vergleichende Objekt. pCompareTo muss eine gültige IWbemClassObject-Instanz sein. null ist nicht zulässig.

Rückgabewert

Die folgenden von dieser Funktion zurückgegebenen Werte werden in der WbemCli.h-Headerdatei definiert, oder Sie können sie als Konstanten im Code definieren:

Konstante Wert Beschreibung
WBEM_E_FAILED 0x80041001 Ein unbekannter Fehler ist aufgetreten.
WBEM_E_INVALID_PARAMETER 0x80041008 Ein Parameter ist ungültig.
WBEM_E_UNEXPECTED 0x8004101d Ein zweiter Aufruf von BeginEnumeration wurde ohne einen dazwischen liegenden Aufruf von EndEnumeration ausgeführt.
WBEM_S_NO_ERROR 0 Der Funktionsaufruf war erfolgreich.
WBEM_S_DIFFERENT 0x40003 Die Objekte sind nicht gleich.
WBEM_S_SAME 0 Die Objekte sind gemäß den Vergleichsflags identisch.

Bemerkungen

Diese Funktion umschließt einen Aufruf der IWbemClassObject::CompareTo-Methode.

Die Flags, die als lEnumFlags-Argument übergeben werden können, werden in der WbemCli.h-Headerdatei definiert, oder Sie können sie als Konstanten in Ihrem Code definieren. Sie können die einzelnen am Vergleich beteiligten Merkmale angeben, indem Sie eine bitweise Kombination der folgenden Flags eingeben:

Konstante Wert Beschreibung
WBEM_FLAG_IGNORE_OBJECT_SOURCE 2 Ignoriert die Quelle (den Server und den Namespace, aus dem sie stammen).
WBEM_FLAG_IGNORE_QUALIFIERS 1 Ignoriert alle Qualifizierer (einschließlich Key und Dynamic).
WBEM_FLAG_IGNORE_DEFAULT_VALUES 4 Ignoriert die Standardwerte von Eigenschaften. Dieses Flag gilt nur für den Vergleich von Klassen.
WBEM_FLAG_IGNORE_FLAVOR 0x20 Ignoriert Qualifizierertypen. Dieses Flag berücksichtigt Qualifizierer, ignoriert jedoch Unterschiede bei den verschiedenen Typen, z. B. Weitergaberegeln und Einschränkungen beim Überschreiben.
WBEM_FLAG_IGNORE_CASE 0x10 Ignoriert Groß-/Kleinschreibung beim Vergleichen von Zeichenfolgenwerten. Dies gilt für Zeichenfolgen und Qualifiziererwerte. Beim Vergleich von Eigenschafts- und Qualifizierernamen wird immer die Groß-/Kleinschreibung beachtet, unabhängig davon, ob dieses Flag festgelegt ist.
WBEM_FLAG_IGNORE_CLASS 0x8 Es wird vorausgesetzt, dass es sich bei den zu vergleichenden Objekten um Instanzen derselben Klasse handelt. Daher vergleicht dieses Flag nur Instanzinformationen. Mithilfe dieser Flags können Sie die Leistung optimieren. Wenn die Objekte nicht zu derselben Klasse gehören, sind die Ergebnisse undefiniert.

Sie können auch wie folgt ein einzelnes zusammengesetztes Flag angeben:

Konstante Wert Beschreibung
WBEM_COMPARISON_INCLUDE_ALL 0 Berücksichtigen Sie alle Features im Vergleich.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: WMINet_Utils.idl

.NET Framework-Versionen: seit Version 4.7.2 verfügbar

Siehe auch