Share via

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

  • Artigo

O método IWbemQualifierSet::Next recupera o próximo qualificador em uma enumeração que começou com IWbemQualifierSet::BeginEnumeration. Esse método é chamado repetidamente para enumerar todos os qualificadores até que WBEM_S_NO_MORE_DATA retorne. Para encerrar a enumeração antecipadamente, chame IWbemQualifierSet::EndEnumeration.

A ordem dos qualificadores retornados durante a enumeração não está definida.

Sintaxe

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

Parâmetros

[in] lFlags

Reservado. Esse parâmetro deve ser 0 (zero).

[out] pstrName

Esse parâmetro recebe o nome do qualificador. Um novo BSTR é sempre alocado sempre que WBEM_S_NO_ERROR retorna.

Se pstrName for NULL, ele será ignorado; caso contrário, o chamador deve garantir que esse parâmetro não aponte para um BSTR válido na entrada ou, caso contrário, haverá uma perda de memória. Além disso, o chamador deve se lembrar de chamar SysFreeString na cadeia de caracteres retornada quando ela não for mais necessária.

[out] pVal

Esse parâmetro recebe o valor do qualificador. VariantInit é chamado na VARIANT por esse método. 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 pVal não será modificada. Esse parâmetro será ignorado se definido como NULL.

[out] plFlavor

Se não for NULL, o valor apontado será definido como o tipo de qualificador. Para obter mais informações, consulte Tipos de qualificador e WBEM_FLAVOR_TYPE.

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

Requisito Valor
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho wbemcli.h (include Wbemidl.h)
Biblioteca Wbemuuid.lib
DLL Fastprox.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll

Confira também

IWbemQualifierSet::BeginEnumeration

IWbemQualifierSet::EndEnumeration

Variantes de qualificador