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
| 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