Função GetPropertyHandle
Retorna um identificador exclusivo que reconhece uma propriedade.
Observação
Esta API é somente para uso interno. Ela não é destinada ao uso do código do desenvolvedor.
Sintaxe
HRESULT GetPropertyHandle (
[in] int vFunc,
[in] IWbemObjectAccess* ptr,
[in] LPCWSTR wszPropertyName,
[out] CIMTYPE* pType,
[out] long* pHandle
);
Parâmetros
vFunc
[in] Esse parâmetro não está em uso.
ptr
[in] Um ponteiro para uma instância IWbemObjectAccess.
wszPropertyName
[in] Uma cadeia de caracteres com terminação nula de caracteres codificados em UTF16 que contém o nome da propriedade.
pType
[out] Um ponteiro para um membro de enumeração CIMTYPE que representa o tipo CIM da propriedade.
pHandle
[out] Um ponteiro para um inteiro que contém o identificador de propriedade.
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_NOT_FOUND |
0x80041002 | O nome da propriedade especificado não foi encontrado. |
WBEM_E_INVALID_PARAMETER |
0x80041008 | Um parâmetro não é válido. |
WBEM_E_NOT_SUPPORTED |
0x8004100c | A propriedade solicitada é do tipo CIM_OBJECT ou CIM_ARRAY. |
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::GetPropertyHandle.
Você pode usar esse identificador para identificar propriedades ao usar métodos IWbemObjectAccess para ler ou gravar valores de propriedade.
Os identificadores podem ser recuperados para propriedades de todos os tipos de dados diferentes de CIM_OBJECT e CIM_ARRAY. Os identificadores retornados funcionam em todas as instâncias de uma classe.
Requisitos
Plataformas: confira Requisitos do sistema.
Header: WMINet_Utils.idl
Versões do .NET Framework: Disponível desde 4.7.2
