Metodo IWbemContext::Next (wbemcli.h)

Il metodo IWbemContext::Next recupera il valore successivo in un'enumerazione di tutti i valori di contesto che iniziano con IWbemContext::BeginEnumeration.

Sintassi

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

Parametri

[in] lFlags

Riservato. Questo parametro deve essere 0.

[out] pstrName

Questo parametro non può essere NULL. Il puntatore non deve puntare a un BSTR attivo all'ingresso e, idealmente, deve essere impostato su NULL. Se non viene restituito alcun codice di errore, viene impostato in modo che punti a una nuova stringa BSTR allocata contenente il nome del valore di contesto.

Il chiamante deve chiamare SysFreeString sulla stringa restituita quando non è più necessario. Se WBEM_S_NO_MORE_DATA restituisce un risultato, pstrName viene impostato su NULL, nel qual caso SysFreeString non deve essere chiamato. Si noti che se pstrName punta a un valore BSTR valido all'ingresso, questa stringa BSTR non viene liberata e si verifica una perdita di memoria.

[out] pValue

Questo parametro non può essere NULL e deve puntare a un valore VARIANT vuoto o non inizializzato. Se non viene restituito alcun errore, variant viene inizializzato utilizzando VariantInit e quindi impostato per contenere il valore di contesto. 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 pValue viene lasciata invariata.

Se WBEM_S_NO_MORE_DATA restituisce un risultato, questo parametro viene impostato in modo che punti a un valore VARIANT di tipo VT_NULL.

È possibile che venga restituito un intero oggetto IWbemClassObject all'interno di VARIANT. In tal caso, VT_UNKNOWN è il tipo VARIANT . Il chiamante può accettare il puntatore IUnknown ed eseguire QueryInterface per ottenere il puntatore IWbemClassObject .

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

IWbemContext

IWbemContext::BeginEnumeration

IWbemContext::EndEnumeration