Partilhar via

Função GetPropertyHandle

  • Artigo

Devolve um identificador exclusivo que identifica uma 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 GetPropertyHandle (
   [in] int                  vFunc,
   [in] IWbemObjectAccess*   ptr,
   [in] LPCWSTR              wszPropertyName,
   [out] CIMTYPE*            pType,
   [out] long*               pHandle
);

Parâmetros

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

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

wszPropertyName
[in] Uma cadeia com terminação nula de carateres codificados em UTF16 que contém o nome da propriedade.

pType
[fora] Um ponteiro para um CIMTYPE membro de enumeração que representa o tipo CIM da propriedade.

pHandle
[fora] Um ponteiro para um número inteiro que contém a alça de propriedade.

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_NOT_FOUND 0x80041002 O nome da propriedade especificada não foi encontrado.
WBEM_E_INVALID_PARAMETER 0x80041008 Um parâmetro não é válido.
WBEM_E_NOT_SUPPORTED 0x8004100c A propriedade pedida é do tipo ou CIM_OBJECTCIM_ARRAY.
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::GetPropertyHandle .

Pode utilizar este identificador para identificar propriedades ao utilizar métodos IWbemObjectAccess para ler ou escrever valores de propriedade.

Os identificadores podem ser obtidos para propriedades de todos os tipos de dados que não CIM_OBJECT sejam e CIM_ARRAY. Os identificadores devolvidos funcionam em todas as instâncias de uma classe.

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