função QualifierSet_Next

Artigo
05/09/2023

Obtém o próximo qualificador numa enumeração que começou com uma chamada para a função QualifierSet_BeginEnumeration .

Nota

Esta API destina-se apenas a utilização interna. Não se destina a ser utilizado a partir do código do programador.

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] Este parâmetro não é utilizado.

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

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

pstrName [fora] O nome do qualificador. Se null, este parâmetro for ignorado; caso contrário, pstrName não deve apontar para uma fuga de memória válida BSTR ou ocorre. Se não for nulo, a função aloca sempre um novo BSTR quando devolve WBEM_S_NO_ERROR.

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

plFlavor [fora] Um ponteiro para um LONG que recebe o sabor qualificador. Se as informações de sabor não forem pretendidas, este parâmetro pode ser null.

Valor devolvido

Os seguintes valores devolvidos por esta função são definidos no ficheiro de cabeçalho WbemCli.h ou pode defini-los como constantes no 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 ligou QualifierSet_BeginEnumeration.
`WBEM_E_OUT_OF_MEMORY`	0x80041006	Não existe memória suficiente disponível para iniciar uma nova enumeração.
`WBEM_S_NO_MORE_DATA`	0x40005	Não existem mais qualificadores na enumeração.
`WBEM_S_NO_ERROR`	0	A chamada de função foi efetuada com êxito.

Observações

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

Chama a QualifierSet_Next função repetidamente para enumerar todos os qualificadores até a função devolver WBEM_S_NO_MORE_DATA. Para terminar a enumeração mais cedo, chame a função QualifierSet_EndEnumeration .

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

Requisitos

Plataformas: Veja Requisitos do Sistema.

Cabeçalho: WMINet_Utils.idl

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

Ver também

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

Partilhar via