Compartilhar via

Função GetPropertyQualifierSet

  • Artigo

Recupera o qualificador definido para uma propriedade específica.

Observação

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

Sintaxe

HRESULT GetPropertyQualifierSet (
   [in] int                 vFunc,
   [in] IWbemClassObject*   ptr,
   [in] LPCWSTR             wszProperty,
   [out] IWbemQualifierSet  **ppQualSet
);

Parâmetros

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

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

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

ppQualSet
[out] Recebe o ponteiro de interface que permite o acesso aos qualificadores da propriedade. ppQualSet não pode ser null. Se ocorrer um erro, um novo objeto não será retornado e o ponteiro será definido para apontar para null.

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_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 há memória disponível suficiente 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 de função foi bem-sucedida.

Comentários

Essa função encapsula uma chamada para o método IWbemClassObject::GetPropertyQualifierSet.

Uma chamada a essa função só terá suporte se o objeto atual for uma definição de classe CIM. A manipulação de método não está disponível para ponteiros IWbemClassObject que apontam para instâncias CIM.

Como cada método pode ter seus próprios qualificadores, o ponteiro IWbemQualifierSet permite que o chamador adicione, edite ou exclua esses qualificadores.

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

Requisitos

Plataformas: confira Requisitos do sistema.

Header: WMINet_Utils.idl

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

Confira também