Função GetPropertyOrigin
Determina a classe na qual uma propriedade é declarada.
Observação
Esta API é somente para uso interno. Ela não é destinada ao uso do código do desenvolvedor.
Sintaxe
HRESULT GetPropertyOrigin (
[in] int vFunc,
[in] IWbemClassObject* ptr,
[in] LPCWSTR wszMethodName,
[out] BSTR* pstrClassName
);
Parâmetros
vFunc
[in] Esse parâmetro não está em uso.
ptr
[in] Um ponteiro para uma instância IWbemClassObject.
wszMethodName
[in] O nome da propriedade para o objeto cuja classe de propriedade está sendo solicitada.
pstrClassName
[out] Recebe o nome da classe que possui a 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_FAILED |
0x80041001 | Houve uma falha geral. |
WBEM_E_NOT_FOUND |
0x80041002 | A propriedade especificada não foi encontrada. |
WBEM_E_INVALID_PARAMETER |
0x80041008 | Um parâmetro não é válido. |
WBEM_E_OUT_OF_MEMORY |
0x80041006 | Não há memória disponível suficiente para concluir a operação. |
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::GetPropertyOrigin.
Como uma classe pode herdar propriedades de uma ou mais classes base, os desenvolvedores geralmente devem determinar a classe na qual uma determinada propriedade é definida.
O parâmetro pstrClassName não pode apontar para um BSTR válido antes que a função seja chamada porque esse é um parâmetro out. Esse ponteiro não é desalocado após o retorno da função.
Requisitos
Plataformas: confira Requisitos do sistema.
Header: WMINet_Utils.idl
Versões do .NET Framework: Disponível desde 4.7.2
