Udostępnij przez

QualifierSet_Next, funkcja

Pobiera następny kwalifikator w wyliczenie, które zaczęło się od wywołania funkcji QualifierSet_BeginEnumeration .

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

Parametry

vFunc [w] Ten parametr jest nieużywany.

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

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

pstrName [out] Nazwa kwalifikatora. Jeśli nullparametr jest ignorowany; w przeciwnym razie pstrName nie należy wskazywać prawidłowego BSTR lub występuje wyciek pamięci. Jeśli nie ma wartości null, funkcja zawsze przydziela nową BSTR wartość, gdy zwraca WBEM_S_NO_ERRORwartość .

pVal [out] Po pomyślnym zakończeniu wartość kwalifikatora. Jeśli funkcja nie powiedzie się, VARIANT wskazywany przez pVal nie jest modyfikowany. Jeśli ten parametr to null, parametr jest ignorowany.

plFlavor [out] Wskaźnik na LONG, który otrzymuje smak kwalifikatora. Jeśli informacje o smaku nie są pożądane, ten parametr może być null.

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_INVALID_PARAMETER 0x80041008 Parametr jest nieprawidłowy.
WBEM_E_UNEXPECTED 0x8004101d Rozmówc nie zadzwonił QualifierSet_BeginEnumeration.
WBEM_E_OUT_OF_MEMORY 0x80041006 Za mało pamięci, aby rozpocząć nową wyliczenie.
WBEM_S_NO_MORE_DATA 0x40005 Wyliczenie nie pozostało więcej kwalifikatorów.
WBEM_S_NO_ERROR 0 Wywołanie funkcji zakończyło się pomyślnie.

Uwagi

Ta funkcja zawija wywołanie metody IWbemQualifierSet::Next .

QualifierSet_Next Funkcja jest wywoływana wielokrotnie w celu wyliczenia wszystkich kwalifikatorów do momentu zwrócenia WBEM_S_NO_MORE_DATAfunkcji . Aby zakończyć wyliczanie na początku, wywołaj funkcję QualifierSet_EndEnumeration .

Kolejność kwalifikatorów zwracanych podczas wyliczania jest niezdefiniowana.

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: WMINet_Utils.idl

.NET Framework wersje: dostępne od wersji 4.7.2

Zobacz też

  • Last updated on