Método IWbemContext::Next (wbemcli.h)

  • Artigo

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 .

Nota No final da enumeração, WBEM_S_NO_MORE_DATA é retornado. O VARIANT retornado é do tipo VT_NULL e o pstrName retornado é NULL.
 

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

Confira também

IWbemContext

IWbemContext::BeginEnumeration

IWbemContext::EndEnumeration