Metodo IWbemContext::Next (wbemcli.h)

Articolo
08/27/2023

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 .

Nota Alla fine dell'enumerazione, viene restituito WBEM_S_NO_MORE_DATA. Variant restituito è di tipo VT_NULL e il valore pstrName restituito è NULL.

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


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	Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wmipjobj.dll

Vedi anche

IWbemContext

IWbemContext::BeginEnumeration

IWbemContext::EndEnumeration

Condividi tramite