Método IWbemContext::Next (wbemcli.h)
O método IWbemContext::Next recupera o próximo valor em uma enumeração de todos os valores de contexto começando com IWbemContext::BeginEnumeration.
Sintaxe
HRESULT Next(
[in] long lFlags,
[out] BSTR *pstrName,
[out] VARIANT *pValue
);
Parâmetros
[in] lFlags
Reservado. Esse parâmetro deve ser 0.
[out] pstrName
Esse parâmetro não pode ser NULL. O ponteiro não deve apontar para um BSTR ativo na entrada e, idealmente, ele deve ser definido para apontar para NULL. Se nenhum código de erro for retornado, ele será definido para apontar para um BSTR recém-alocado que contém o nome do valor de contexto.
O chamador deve chamar SysFreeString na cadeia de caracteres retornada quando ela não for mais necessária. Se WBEM_S_NO_MORE_DATA retornar, pstrName será definido para apontar para NULL; nesse caso, SysFreeString não deve ser chamado. Observe que, se pstrName apontar para um BSTR válido na entrada, esse BSTR não será liberado e ocorrerá um vazamento de memória.
[out] pValue
Esse parâmetro não pode ser NULL e deve apontar para um VARIANT vazio ou não inicializado. Se nenhum erro for retornado, o VARIANT será inicializado usando VariantInit e definido para conter o valor de contexto. O chamador deve chamar VariantClear nesse ponteiro quando o valor não for mais necessário. Se um código de erro for retornado, a VARIANT apontada por pValue será deixada sem modificações.
Se WBEM_S_NO_MORE_DATA retornar, esse parâmetro será definido para apontar para uma VARIANT do tipo VT_NULL.
É possível que um objeto IWbemClassObject inteiro possa ser retornado dentro da VARIANT. Se esse for o caso, VT_UNKNOWN será o tipo VARIANT . O chamador pode pegar o ponteiro IUnknown e executar QueryInterface para obter o ponteiro IWbemClassObject .
Retornar valor
Esse método retorna um HRESULT que indica o status da chamada de método. A lista a seguir lista o valor contido em um HRESULT.
Requisitos
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | wbemcli.h (inclua Wbemidl.h) |
| Biblioteca | Wbemuuid.lib |
| DLL | Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wmipjobj.dll |