Partilhar via

Função GetPropertyQualifierSet

  • Artigo

Obtém o conjunto de qualificadores para uma determinada propriedade.

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 GetPropertyQualifierSet (
   [in] int                 vFunc,
   [in] IWbemClassObject*   ptr,
   [in] LPCWSTR             wszProperty,
   [out] IWbemQualifierSet  **ppQualSet
);

Parâmetros

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

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

wszMethod
[in] O nome da propriedade. wszProperty tem de apontar para um válido LPCWSTR.

ppQualSet
[fora] Recebe o ponteiro da interface que permite o acesso aos qualificadores da propriedade. ppQualSet não pode ser null. Se ocorrer um erro, não é devolvido um novo objeto e o ponteiro está definido para apontar para 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_FAILED 0x80041001 Houve uma falha geral.
WBEM_E_NOT_FOUND 0x80041002 O método especificado não existe.
WBEM_E_OUT_OF_MEMORY 0x80041006 Não existe memória suficiente disponível para concluir a operação.
WBEM_E_INVALID_PARAMETER 0x80041008 Um parâmetro é null.
WBEM_E_SYSTEM_PROPERTY 0x80041030 A função tenta obter qualificadores de uma propriedade do sistema.
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 IWbemClassObject::GetPropertyQualifierSet .

Uma chamada para esta função só é suportada se o objeto atual for uma definição de classe CIM. A manipulação de métodos não está disponível para ponteiros IWbemClassObject que apontem para instâncias CIM.

Uma vez que cada método pode ter os seus próprios qualificadores, o ponteiro IWbemQualifierSet permite que o autor da chamada adicione, edite ou elimine estes qualificadores.

Como as propriedades do sistema não têm qualificadores, a função devolve WBEM_E_SYSTEM_PROPERTY se tentar obter um ponteiro IWbemQualifierSet para uma propriedade do sistema.

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