Metodo IWbemQualifierSet::Next (wbemcli.h)

Il metodo IWbemQualifierSet::Next recupera il qualificatore successivo in un'enumerazione avviata con IWbemQualifierSet::BeginEnumeration. Questo metodo viene chiamato ripetutamente per enumerare tutti i qualificatori fino a quando non WBEM_S_NO_MORE_DATA restituisce . Per terminare l'enumerazione in anticipo, chiamare IWbemQualifierSet::EndEnumeration.

L'ordine dei qualificatori restituiti durante l'enumerazione non è definito.

Sintassi

HRESULT Next(
  [in]  long    lFlags,
  [out] BSTR    *pstrName,
  [out] VARIANT *pVal,
  [out] long    *plFlavor
);

Parametri

[in] lFlags

Riservato. Questo parametro deve essere 0 (zero).

[out] pstrName

Questo parametro riceve il nome del qualificatore. Un nuovo BSTR viene sempre allocato ogni volta che WBEM_S_NO_ERROR restituisce .

Se pstrName è NULL, viene ignorato; in caso contrario, il chiamante deve assicurarsi che questo parametro non punti a un valore BSTR valido all'ingresso oppure che si verifichi una perdita di memoria. Inoltre, il chiamante deve ricordare di chiamare SysFreeString sulla stringa restituita quando non è più necessario.

[out] pVal

Questo parametro riceve il valore per il qualificatore. VariantInit viene chiamato su VARIANT da questo metodo. Il chiamante deve chiamare VariantClear su questo puntatore quando il valore non è più necessario. Se viene restituito un codice di errore , la variante a cui punta pVal viene lasciata invariata. Questo parametro viene ignorato se impostato su NULL.

[out] plFlavor

Se non è NULL, il valore a cui punta viene impostato sul sapore del qualificatore. Per altre informazioni, vedere Tipi di qualificatore e WBEM_FLAVOR_TYPE.

Valore restituito

Questo metodo restituisce un valore HRESULT che indica lo stato della chiamata al metodo. L'elenco seguente elenca il valore contenuto in hrESULT.

Requisiti

Vedi anche

IWbemQualifierSet::BeginEnumeration

IWbemQualifierSet::EndEnumeration

Tipi di qualificatore