função QualifierSet_GetNames

Obtém os nomes de todos os qualificadores ou de determinados qualificadores que estão disponíveis a partir do objeto ou propriedade atual.

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_GetNames (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags,
   [out] SAFEARRAY (BSTR)**  pstrNames
);

Parâmetros

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

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

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

Constante	Valor	Descrição
	0	Devolva os nomes de todos os qualificadores.
WBEM_FLAG_LOCAL_ONLY	0x10	Devolva 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. Para uma instância: devolver apenas nomes de qualificação específicos de instâncias. Para uma classe: devolver apenas qualificadores específicos da classe 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. Para uma instância: devolva apenas os qualificadores propagados da definição de classe. Para uma classe: devolva apenas os nomes de qualificação herdados das classes principais.

pstrNames
[fora] Uma nova SAFEARRAY que contém os nomes pedidos. A matriz pode ter 0 elementos. Se ocorrer um erro, não é devolvido um novo SAFEARRAY .

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_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 de função foi efetuada com êxito.

Observações

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

Depois de obter os nomes dos qualificadores, pode aceder a cada qualificador por nome ao chamar a função QualifierSet_Get .

Não é um erro para um determinado objeto ter zero qualificadores, pelo que o número de cadeias em pstrNames devolvido pode ser 0, mesmo que a função devolva WBEM_S_NO_ERROR.

Requisitos

Plataformas: Veja Requisitos do Sistema.

Cabeçalho: WMINet_Utils.idl

.NET Framework Versões: Disponível desde 4.7.2

Ver também

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