Funkce CompareTo

Porovná objekt s jiným objektem správy systému Windows.

Poznámka

Toto rozhraní API je pouze pro interní použití. Není určen pro použití z vývojářského kódu.

Syntaxe

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

Parametry

vFunc
[v] Tento parametr se nepoužívá.

ptr
[v] Ukazatel na instanci IWbemClassObject .

flags
[v] Bitové kombinace příznaků, které určují vlastnosti objektu, které se mají zvážit pro porovnání. Další informace najdete v části Poznámky .

pCompareTo
[v] Objekt pro porovnání. pCompareTo musí být platný IWbemClassObject instance; nemůže to být null.

Vrácená hodnota

Následující hodnoty vrácené touto funkcí jsou definovány v souboru hlaviček WbemCli.h nebo je můžete definovat jako konstanty ve vašem kódu:

Konstanta Hodnota Popis
WBEM_E_FAILED 0x80041001 Došlo k nespecifikované chybě.
WBEM_E_INVALID_PARAMETER 0x80041008 Parametr je neplatný.
WBEM_E_UNEXPECTED 0x8004101d Druhý hovor na BeginEnumeration adresu byl proveden bez zasahujícího hovoru na EndEnumerationadresu .
WBEM_S_NO_ERROR 0 Volání funkce bylo úspěšné.
WBEM_S_DIFFERENT 0x40003 Objekty se liší.
WBEM_S_SAME 0 Objekty jsou stejné na základě příznaků porovnání.

Poznámky

Tato funkce zabalí volání metody IWbemClassObject::CompareTo .

Příznaky, které lze předat jako lEnumFlags argument, jsou definovány v hlavičce souboru WbemCli.h nebo je můžete definovat jako konstanty v kódu. Jednotlivé charakteristiky, které jsou součástí porovnání, můžete určit zadáním bitové kombinace následujících příznaků:

Konstanta Hodnota Popis
WBEM_FLAG_IGNORE_OBJECT_SOURCE 2 Ignorujte zdroj (server a obor názvů, ze které pocházejí).
WBEM_FLAG_IGNORE_QUALIFIERS 1 Ignorovat všechny kvalifikátory (včetně klíče a dynamického)
WBEM_FLAG_IGNORE_DEFAULT_VALUES 4 Ignorovat výchozí hodnoty vlastností. Tento příznak se vztahuje pouze na porovnání tříd.
WBEM_FLAG_IGNORE_FLAVOR 0x20 Ignorovat příchuť kvalifikátoru Tento příznak stále bere v úvahu kvalifikátory, ale ignoruje rozdíly v příchuti, jako jsou pravidla šíření a přepsání omezení.
WBEM_FLAG_IGNORE_CASE 0x10 Při porovnávání řetězcových hodnot ignorujte velká a velká písmena. To platí pro řetězce i hodnoty kvalifikátoru. Při porovnávání názvů vlastností a kvalifikátorů se vždy rozlišují malá a velká písmena bez ohledu na to, jestli je tento příznak nastavený.
WBEM_FLAG_IGNORE_CLASS 0x8 Předpokládejme, že porovnávané objekty jsou instance stejné třídy. V důsledku toho tento příznak porovnává pouze informace související s instancemi. Tyto příznaky použijte k optimalizaci výkonu. Pokud objekty nejsou stejné třídy, výsledky nejsou definovány.

Nebo můžete zadat jeden složený příznak následujícím způsobem:

Konstanta Hodnota Popis
WBEM_COMPARISON_INCLUDE_ALL 0 Vezměte v úvahu všechny funkce v porovnání.

Požadavky

Platformy: Viz Požadavky na systém.

Záhlaví: WMINet_Utils.idl

Verze rozhraní .NET Framework: K dispozici od verze 4.7.2

Viz také

  • Last updated on