função QualifierSet_BeginEnumeration

Artigo
04/11/2023

Repõe um enumerador dos qualificadores de um objeto para o início da enumeração.

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_BeginEnumeration (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags
);

Parâmetros

vFunc
[in] Este parâmetro não é utilizado.

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

lFlags
[in] Uma combinação bit-a-bit dos sinalizadores ou valores descritos na secção Observações que especifica os qualificadores a incluir na enumeração.

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	O `lFlags` parâmetro não é válido.
`WBEM_E_UNEXPECTED`	0x8004101d	Uma segunda chamada para `QualifierSet_BeginEnumeration` foi feita sem uma chamada interveniente para `QualifierSet_EndEnumeration`.
`WBEM_E_OUT_OF_MEMORY`	0x80041006	Não existe memória suficiente disponível para iniciar uma nova enumeração.
`WBEM_S_NO_ERROR`	0	A chamada da função foi efetuada com êxito.

Observações

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

Para enumerar todos os qualificadores num objeto, este método tem de ser chamado antes da primeira chamada para QualifierSet_Next. A ordem pela qual os qualificadores são enumerados é garantidamente invariável para uma determinada enumeração.

Os sinalizadores que podem ser transmitidos como o lEnumFlags argumento são definidos no ficheiro de cabeçalho WbemCli.h ou pode defini-los como constantes no seu código.

Constante	Valor	Descrição
	0	Devolver os nomes de todos os qualificadores.
`WBEM_FLAG_LOCAL_ONLY`	0x10	Devolver apenas os nomes dos qualificadores específicos da propriedade ou objeto atual. Para uma propriedade: devolva apenas os qualificadores específicos da propriedade (incluindo substituições) e não os qualificadores propagados da definição de classe. Por exemplo: devolver apenas nomes de qualificadores específicos de instâncias. Para uma classe: devolver apenas qualificadores específicos da classe que está a ser derivada.
`WBEM_FLAG_PROPAGATED_ONLY`	0x20	Devolver apenas os nomes dos qualificadores propagados de outro objeto. Para uma propriedade: devolva apenas os qualificadores propagados para esta propriedade a partir da definição de classe e não os da própria propriedade. Por exemplo: devolver apenas os qualificadores propagados da definição de classe. Para uma classe: devolver apenas os nomes de qualificadores herdados das classes principais.

Requisitos

Plataformas: Veja Requisitos de Sistema.

Cabeçalho: WMINet_Utils.idl

.NET Framework Versões: Disponível desde a versão 4.7.2

Ver também

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

Partilhar via