QualifierSet_BeginEnumeration, funkcja

Resetuje moduł wyliczający kwalifikatorów obiektu 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 QualifierSet_BeginEnumeration (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags
);

Parametry

vFunc
[in] Ten parametr jest nieużywany.

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

lFlags
[in] Bitowa kombinacja flag lub wartości opisanych w sekcji Uwagi , która określa kwalifikatory do uwzględnienia 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	Parametr lFlags jest nieprawidłowy.
WBEM_E_UNEXPECTED	0x8004101d	Drugie wezwanie do QualifierSet_BeginEnumeration zostało wykonane bez pośredniczącego połączenia z QualifierSet_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 IWbemQualifierSet::BeginEnumeration .

Aby wyliczyć wszystkie kwalifikatory obiektu, należy wywołać tę metodę przed pierwszym wywołaniem, aby QualifierSet_Next. Kolejność, w jakiej kwalifikatory są wyliczane, musi być niezmienna dla danego wyliczenia.

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.

Stała	Wartość	Opis
	0	Zwróć nazwy wszystkich kwalifikatorów.
WBEM_FLAG_LOCAL_ONLY	0x10	Zwraca tylko nazwy kwalifikatorów specyficznych dla bieżącej właściwości lub obiektu. Dla właściwości: Zwróć tylko kwalifikatory specyficzne dla właściwości (w tym przesłonięcia), a nie te kwalifikatory propagowane z definicji klasy. W przypadku wystąpienia: Zwracaj tylko nazwy kwalifikatora specyficzne dla wystąpienia. Dla klasy: Zwracaj tylko kwalifikatory specyficzne dla klasy pochodnej.
WBEM_FLAG_PROPAGATED_ONLY	0x20	Zwraca tylko nazwy kwalifikatorów propagowanych z innego obiektu. Dla właściwości: Zwróć tylko kwalifikatory propagowane do tej właściwości z definicji klasy, a nie do tych z samej właściwości. W przypadku wystąpienia: zwróć tylko te kwalifikatory propagowane z definicji klasy. Dla klasy: Zwracaj tylko te nazwy kwalifikatora dziedziczone z klas nadrzędnych.

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: WMINet_Utils.idl

wersje .NET Framework: dostępne od wersji 4.7.2

Zobacz też

• Liczniki usługi WMI i wydajności (niezarządzana dokumentacja interfejsu API)