Função QualifierSet_Next

Artigo
05/09/2023

Recupera o próximo qualificador em uma enumeração que começou com uma chamada para a função QualifierSet_BeginEnumeration.

Observação

Esta API é somente para uso interno. Ela não é destinada ao uso do código do desenvolvedor.

Sintaxe

HRESULT QualifierSet_Next (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags,
   [out] BSTR*               pstrName,
   [out] VARIANT*            pVal,
   [out] LONG*               plFlavor
);

Parâmetros

vFunc [in] Esse parâmetro não está em uso.

ptr [in] Um ponteiro para uma instância IWbemQualifierSet.

lFlags [in] Reservado. Este parâmetro deve ser 0.

pstrName O nome do qualificador. Se null, esse parâmetro é ignorado, caso contrário, pstrName não deverá apontar para um BSTR válido ou ocorrerá um vazamento de memória. Se não for nula, a função sempre alocará uma nova BSTR quando retornar WBEM_S_NO_ERROR.

pVal [out] Quando bem-sucedido, o valor para o qualificador. Se a função falhar, o VARIANT apontado por pVal não será modificado. Se esse for parâmetro null, o parâmetro é ignorado.

plFlavor [out] Um ponteiro para um LONG que recebe o tipo de qualificador. Se as informações de tipo não forem desejadas, esse parâmetro pode ser null.

Valor retornado

Os seguintes valores retornados por essa função são definidos no arquivo de cabeçalho WbemCli.h, ou você pode defini-los como constantes em seu código:

Constante	Valor	Descrição
`WBEM_E_INVALID_PARAMETER`	0x80041008	Um parâmetro não é válido.
`WBEM_E_UNEXPECTED`	0x8004101d	O chamador não chamou QualifierSet_BeginEnumeration.
`WBEM_E_OUT_OF_MEMORY`	0x80041006	Não há memória suficiente disponível para iniciar uma nova enumeração.
`WBEM_S_NO_MORE_DATA`	0x40005	Não restam mais qualificadores na enumeração.
`WBEM_S_NO_ERROR`	0	A chamada de função foi bem-sucedida.

Comentários

Essa função encapsula uma chamada para o método IWbemQualifierSet::Next.

Você chama a função QualifierSet_Next repetidamente para enumerar todos os qualificadores até que a função retorne WBEM_S_NO_MORE_DATA. Para encerrar a enumeração antecipadamente, chame a função QualifierSet_EndEnumeration.

A ordem dos qualificadores retornados durante a enumeração é indefinida.

Requisitos

Plataformas: confira Requisitos do sistema.

Header: WMINet_Utils.idl

Versões do .NET Framework: Disponível desde 4.7.2

Confira também

WMI e Contadores de Desempenho (Referência de API Não Gerenciada)

Compartilhar via