Função QualifierSet_BeginEnumeration

Artigo
05/10/2023

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

Observação

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

Sintaxe

HRESULT QualifierSet_BeginEnumeration (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags
);

Parâmetros

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

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

lFlags
[in] Uma combinação bit a bit dos sinalizadores ou valores descritos na seção Comentários que especifica os qualificadores a serem incluídos na enumeração.

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	O parâmetro `lFlags` não é válido.
`WBEM_E_UNEXPECTED`	0x8004101d	Uma segunda chamada para `QualifierSet_BeginEnumeration` foi feita sem uma chamada intervindo para `QualifierSet_EndEnumeration`.
`WBEM_E_OUT_OF_MEMORY`	0x80041006	Não há memória suficiente disponível para iniciar uma nova 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::BeginEnumeration.

Para enumerar todos os qualificadores em um objeto, esse método precisa ser chamado antes da primeira chamada para QualifierSet_Next. A ordem na qual os qualificadores são enumerados tem a garantia de ser invariável para uma determinada enumeração.

Os sinalizadores que podem ser passados como o argumento lEnumFlags 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
	0	Retorne os nomes de todos os qualificadores.
`WBEM_FLAG_LOCAL_ONLY`	0x10	Retorne apenas os nomes de qualificadoras específicos à propriedade ou objeto atual. Para uma propriedade: retorne apenas os qualificadores específicos à propriedade (incluindo substituições) e não os qualificadores propagados da definição de classe. Para uma instância: retornar apenas nomes de qualificador específicos da instância. Para uma classe: retornar somente qualificadores específicos para a classe que está sendo derivada.
`WBEM_FLAG_PROPAGATED_ONLY`	0x20	Retorne apenas os nomes dos qualificadores propagados de outro objeto. Para uma propriedade: retorne apenas os qualificadores propagados para essa propriedade da definição de classe e não aqueles da propriedade em si. Para uma instância: retorne somente os qualificadores propagados da definição de classe. Para uma classe: retorne apenas os nomes do qualificador herdados das classes pai.

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