Partilhar via

função QualifierSet_Next

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

  • Last updated on