Compartilhar via

Função QualifierSet_Next

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

  • Last updated on