Metodo IWbemQualifierSet::Next (wbemcli.h)

  • Articolo

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

Requisito Valore
Client minimo supportato Windows Vista
Server minimo supportato Windows Server 2008
Piattaforma di destinazione Windows
Intestazione wbemcli.h (include Wbemidl.h)
Libreria Wbemuuid.lib
DLL Fastprox.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll

Vedi anche

IWbemQualifierSet::BeginEnumeration

IWbemQualifierSet::EndEnumeration

Tipi di qualificatore