Udostępnij przez

CompareTo, funkcja

Porównuje obiekt z innym obiektem zarządzania systemu Windows.

Uwaga

Ten interfejs API jest przeznaczony tylko do użytku wewnętrznego. Nie jest przeznaczony do użycia z poziomu kodu dewelopera.

Składnia

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

Parametry

vFunc
[in] Ten parametr jest nieużywany.

ptr
[in] Wskaźnik do wystąpienia IWbemClassObject .

flags
[in] Bitowa kombinacja flag określających cechy obiektu do rozważenia w celu porównania. Aby uzyskać więcej informacji, zobacz sekcję Uwagi .

pCompareTo
[in] Obiekt do porównania. pCompareTo musi być prawidłowym wystąpieniem IWbemClassObject ; nie może to być null.

Wartość zwracana

Następujące wartości zwracane przez tę funkcję są definiowane w pliku nagłówkowym WbemCli.h lub można je zdefiniować jako stałe w kodzie:

Stała Wartość Opis
WBEM_E_FAILED 0x80041001 Wystąpił nieokreślony błąd.
WBEM_E_INVALID_PARAMETER 0x80041008 Parametr jest nieprawidłowy.
WBEM_E_UNEXPECTED 0x8004101d Drugie wezwanie do BeginEnumeration zostało wykonane bez pośredniczącego połączenia z EndEnumeration.
WBEM_S_NO_ERROR 0 Wywołanie funkcji zakończyło się pomyślnie.
WBEM_S_DIFFERENT 0x40003 Obiekty są różne.
WBEM_S_SAME 0 Obiekty są takie same na podstawie flag porównania.

Uwagi

Ta funkcja opakowuje wywołanie metody IWbemClassObject::CompareTo .

Flagi, które można przekazać jako lEnumFlags argument, są zdefiniowane w pliku nagłówka WbemCli.h lub można je zdefiniować jako stałe w kodzie. Poszczególne cechy związane z porównaniem można określić, określając bitową kombinację następujących flag:

Stała Wartość Opis
WBEM_FLAG_IGNORE_OBJECT_SOURCE 2 Ignoruj źródło (serwer i przestrzeń nazw, z której pochodzą).
WBEM_FLAG_IGNORE_QUALIFIERS 1 Ignoruj wszystkie kwalifikatory (w tym klucz i dynamiczny)
WBEM_FLAG_IGNORE_DEFAULT_VALUES 4 Ignoruj wartości domyślne właściwości. Ta flaga dotyczy tylko porównania klas.
WBEM_FLAG_IGNORE_FLAVOR 0x20 Ignoruj smaki kwalifikatora. Ta flaga nadal uwzględnia kwalifikatory, ale ignoruje różnice smakowe, takie jak reguły propagacji i ograniczenia przesłonięcia.
WBEM_FLAG_IGNORE_CASE 0x10 Ignoruj wielkość liter podczas porównywania wartości ciągów. Dotyczy to zarówno ciągów, jak i wartości kwalifikatora. Porównanie nazw właściwości i kwalifikatora zawsze uwzględnia wielkość liter niezależnie od tego, czy ta flaga jest ustawiona.
WBEM_FLAG_IGNORE_CLASS 0x8 Załóżmy, że porównywane obiekty są wystąpieniami tej samej klasy. W związku z tym ta flaga porównuje tylko informacje związane z wystąpieniem. Użyj tych flag, aby zoptymalizować wydajność. Jeśli obiekty nie są tej samej klasy, wyniki są niezdefiniowane.

Możesz też określić pojedynczą flagę złożoną w następujący sposób:

Stała Wartość Opis
WBEM_COMPARISON_INCLUDE_ALL 0 Rozważ wszystkie funkcje w porównaniu.

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: WMINet_Utils.idl

wersje .NET Framework: dostępne od wersji 4.7.2

Zobacz też

  • Last updated on