NextMethod, funkcja

Pobiera następną metodę w wyliczenie rozpoczynającym się wywołaniem metody BeginMethodEnumeration.

Uwaga

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

Składnia

HRESULT NextMethod (
   [in] int                 vFunc,
   [in] IWbemClassObject*   ptr,
   [in] LONG                lFlags,
   [out] BSTR*              pName,
   [out] IWbemClassObject** ppInSignature,
   [out] IWbemClassObject** ppOutSignature
);

Parametry

vFunc
[w] Ten parametr jest nieużywany.

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

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

pName
[out] Wskaźnik wskazujący null przed wywołaniem. Po powrocie funkcji adres nowego BSTR , który zawiera nazwę metody.

ppSignatureIn
[out] Wskaźnik, który odbiera wskaźnik do obiektu IWbemClassObject , który zawiera in parametry metody .

ppSignatureOut
[out] Wskaźnik, który odbiera wskaźnik do obiektu IWbemClassObject , który zawiera out parametry metody .

Wartość zwracana

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

Stała	Wartość	Opis
WBEM_E_UNEXPECTED	0x8004101d	Nie było wywołania BeginEnumeration funkcji.
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::NextMethod .

Obiekt wywołujący rozpoczyna sekwencję wyliczenia, wywołując funkcję BeginMethodEnumeration , a następnie wywołuje funkcję [NextMethod], aż funkcja zwróci WBEM_S_NO_MORE_DATAwartość . Opcjonalnie obiekt wywołujący kończy sekwencję, wywołując metodę EndMethodEnumeration. Obiekt wywołujący może zakończyć wyliczanie wcześnie, wywołując metodę EndMethodEnumeration w dowolnym momencie.

Przykład

Aby zapoznać się z przykładem języka C++, zobacz metodę IWbemClassObject::NextMethod .

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: WMINet_Utils.idl

.NET Framework wersje: dostępne od wersji 4.7.2

Zobacz też

• Liczniki wydajności i usługi WMI (dokumentacja niezarządzanych interfejsów API)