Função GetPropertyOrigin
Determina a classe na qual uma propriedade é declarada.
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 GetPropertyOrigin (
[in] int vFunc,
[in] IWbemClassObject* ptr,
[in] LPCWSTR wszMethodName,
[out] BSTR* pstrClassName
);
Parâmetros
vFunc
[in] Este parâmetro não é utilizado.
ptr
[in] Um ponteiro para uma instância IWbemClassObject .
wszMethodName
[in] O nome da propriedade do objeto cuja classe proprietária está a ser pedida.
pstrClassName
[fora] Recebe o nome da classe proprietária da 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_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 existe memória suficiente disponível para concluir a operação. |
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::GetPropertyOrigin .
Uma vez que uma classe pode herdar propriedades de uma ou mais classes base, os programadores geralmente querem determinar a propriedade na qual um determinado método é definido.
O pstrClassName parâmetro não pode apontar para um valor válido BSTR antes de a função ser chamada porque se trata de um out parâmetro; este ponteiro não é desalocado após a função ser devolvida.
Requisitos
Plataformas: Veja Requisitos de Sistema.
Cabeçalho: WMINet_Utils.idl
.NET Framework Versões: Disponível desde a versão 4.7.2
