Udostępnij przez

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ż

  • Last updated on