Função QualifierSet_GetNames

Artigo
05/09/2023

Recupera os nomes de todos os qualificadores ou de determinados qualificadores que estão disponíveis por meio do objeto atual ou da propriedade.

Observação

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

Sintaxe

HRESULT QualifierSet_GetNames (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags,
   [out] SAFEARRAY (BSTR)**  pstrNames
);

Parâmetros

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

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

lFlags
[in] Um dos seguintes sinalizadores ou valores que especifica quais nomes incluir na enumeração.

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.

pstrNames
[out] Um novo SAFEARRAY que contém os nomes solicitados. A matriz pode ter elementos 0. Se ocorrer um erro, um novo SAFEARRAY não será retornado.

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_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::GetNames.

Depois de recuperar os nomes do qualificador, você pode acessar cada qualificador pelo nome chamando a função QualifierSet_Get .

Não é um erro para um determinado objeto não ter nenhum qualificador e, portanto, o número de cadeias de caracteres em pstrNames no retorno pode ser 0, mesmo que a função retorne WBEM_S_NO_ERROR.

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