Następna funkcja

Pobiera następną właściwość w wyliczenie rozpoczynającym się od wywołania funkcji BeginEnumeration.

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 Next (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LONG              lFlags,
   [out] BSTR*            pstrName,
   [out] VARIANT*         pVal,
   [out] CIMTYPE*         pvtType,
   [out] LONG*            plFlavor
);

Parametry

vFunc
[in] Ten parametr jest nieużywany.

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

lFlags
[in] Zastrzeżone. Ten parametr musi mieć wartość 0.

pstrName
[out] Nowa BSTR , która zawiera nazwę właściwości. Możesz ustawić ten parametr na null wartość , jeśli nazwa nie jest wymagana.

pVal
[out] Wypełniony VARIANT wartością właściwości . Możesz ustawić ten parametr na null wartość , jeśli wartość nie jest wymagana. Jeśli funkcja zwraca kod błędu, przekazana VARIANT do pVal elementu pozostanie niezmodyfikowana.

pvtType
[out] Wskaźnik do zmiennej CIMTYPE (typ LONG właściwości jest umieszczany). Wartość tej właściwości może być wartością VT_NULL_VARIANT, w takim przypadku konieczne jest określenie rzeczywistego typu właściwości. Ten parametr może również mieć wartość null.

plFlavor
[out] nulllub wartość, która odbiera informacje o pochodzeniu właściwości. Zobacz sekcję [Uwagi], aby uzyskać możliwe wartości.

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ła ogólna awaria.
WBEM_E_INVALID_PARAMETER	0x80041008	Parametr jest nieprawidłowy.
WBEM_E_UNEXPECTED	0x8004101d	Nie było wywołania BeginEnumeration funkcji.
WBEM_E_OUT_OF_MEMORY	0x80041006	Za mało pamięci, aby rozpocząć nowe wyliczenie.
WBEM_E_TRANSPORT_FAILURE	0x80041015	Zdalne wywołanie procedury między bieżącym procesem a zarządzaniem systemem Windows nie powiodło się.
WBEM_S_NO_ERROR	0	Wywołanie funkcji zakończyło się pomyślnie.
WBEM_S_NO_MORE_DATA	0x40005	Wyliczenie nie zawiera więcej właściwości.

Uwagi

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

Ta metoda zwraca również właściwości systemowe.

Jeśli bazowy typ właściwości jest ścieżką obiektu, datą lub godziną lub innym typem specjalnym, zwracany typ nie zawiera wystarczającej ilości informacji. Obiekt wywołujący musi zbadać CIMTYPE właściwość dla określonej właściwości, aby określić, czy właściwość jest odwołaniem do obiektu, datą lub godziną lub innym typem specjalnym.

Jeśli plFlavor wartość nie nulljest równa , LONG wartość otrzymuje informacje o pochodzeniu właściwości w następujący sposób:

Stała	Wartość	Opis
WBEM_FLAVOR_ORIGIN_SYSTEM	0x40	Właściwość jest standardową właściwością systemową.
WBEM_FLAVOR_ORIGIN_PROPAGATED	0x20	Dla klasy: właściwość jest dziedziczona z klasy nadrzędnej. Dla wystąpienia: właściwość dziedziczona z klasy nadrzędnej nie została zmodyfikowana przez wystąpienie.
WBEM_FLAVOR_ORIGIN_LOCAL	0	Dla klasy: właściwość należy do klasy pochodnej. W przypadku wystąpienia: właściwość jest modyfikowana przez wystąpienie; oznacza to, że podano wartość lub dodano lub zmodyfikowano kwalifikator.

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)