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

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

Confira também

IWbemQualifierSet::BeginEnumeration

IWbemQualifierSet::EndEnumeration

Variantes de qualificador