Udostępnij przez

BeingEnumeration, funkcja

Resetuje moduł wyliczający z powrotem na początku wyliczenia.

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 BeginEnumeration (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LONG              lEnumFlags
);

Parametry

vFunc
[in] Ten parametr jest nieużywany.

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

lEnumFlags
[in] Bitowa kombinacja flag lub wartości opisanych w sekcji Uwagi , która kontroluje właściwości zawarte w wyliczenie.

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_INVALID_PARAMETER 0x80041008 Kombinacja flag w pliku lEnumFlags jest nieprawidłowa lub określono nieprawidłowy argument.
WBEM_E_UNEXPECTED 0x8004101d Drugie wezwanie do BeginEnumeration zostało wykonane bez pośredniczącego połączenia z EndEnumeration.
WBEM_E_OUT_OF_MEMORY 0x80041006 Za mało pamięci, aby rozpocząć nowe wyliczenie.
WBEM_S_NO_ERROR 0 Wywołanie funkcji zakończyło się pomyślnie.

Uwagi

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

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. Możesz połączyć jedną flagę z każdej grupy z dowolną flagą z dowolnej innej grupy. Jednak flagi z tej samej grupy wzajemnie się wykluczają.

Grupa 1

Stała Wartość Opis
WBEM_FLAG_KEYS_ONLY 0x4 Uwzględnij właściwości, które stanowią tylko klucz.
WBEM_FLAG_REFS_ONLY 0x8 Uwzględnij tylko właściwości, które są odwołaniami do obiektów.

Grupa 2

Stała Wartość Opis
WBEM_FLAG_SYSTEM_ONLY 0x30 Ogranicz wyliczenie tylko do właściwości systemowych.
WBEM_FLAG_NONSYSTEM_ONLY 0x40 Uwzględnij właściwości lokalne i propagowane, ale wyklucz właściwości systemowe z wyliczenia.

Dla klas:

Stała Wartość Opis
WBEM_FLAG_CLASS_OVERRIDES_ONLY 0x100 Ogranicz wyliczenie do właściwości przesłonięć w definicji klasy.
WBEM_FLAG_CLASS_LOCAL_AND_OVERRIDES 0x100 Ogranicz wyliczenie do właściwości przesłonięć w bieżącej definicji klasy i do nowych właściwości zdefiniowanych w klasie.
WBEM_MASK_CLASS_CONDITION 0x300 Maska (a nie flaga) do zastosowania względem lEnumFlags wartości w celu sprawdzenia, czy WBEM_FLAG_CLASS_OVERRIDES_ONLY jest ustawiona wartość lub WBEM_FLAG_CLASS_LOCAL_AND_OVERRIDES .
WBEM_FLAG_LOCAL_ONLY 0x10 Ogranicz wyliczenie do właściwości zdefiniowanych lub zmodyfikowanych w samej klasie.
WBEM_FLAG_PROPAGATED_ONLY 0x20 Ogranicz wyliczenie do właściwości, które są dziedziczone z klas bazowych.

W przypadku wystąpień:

Stała Wartość Opis
WBEM_FLAG_LOCAL_ONLY 0x10 Ogranicz wyliczenie do właściwości zdefiniowanych lub zmodyfikowanych w samej klasie.
WBEM_FLAG_PROPAGATED_ONLY 0x20 Ogranicz wyliczenie do właściwości, które są dziedziczone z klas bazowych.

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