Função GetMethod

Artigo
05/10/2023

Recupera informações sobre o método especifico.

Observação

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

Sintaxe

HRESULT GetMethod (
   [in] int                vFunc,
   [in] IWbemClassObject*   ptr,
   [in] LPCWSTR             wszName,
   [in] LONG                lFlags,
   [out] IWbemClassObject** ppInSignature,
   [out] IWbemClassObject** ppOutSignature
);

Parâmetros

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

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

wszName
[in] O nome do método. Esse parâmetro não pode ser null e precisa apontar para um LPCWSTR válido.

lFlags
[in] Reservado. Esse parâmetro deve ser 0.

ppInSignature
[out] Um ponteiro para o endereço de uma instância IWbemClassObject que descreve os parâmetros de entrada para o método. Esse parâmetro será ignorado se ele for definido como null.

ppOutSignature
[out] Um ponteiro para o endereço de uma instância IWbemClassObject que descreve os parâmetros de saída para o método. Esse parâmetro será ignorado se ele for definido como 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_NOT_FOUND`	0x80041002	A propriedade especificada não foi encontrada.
`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 ao método IWbemClassObject::GetMethod.

O Gerenciamento do Windows pode definir o ponteiro IWbemClassObject para null se o método não tem parâmetros de entrada.

Em ppInSignature e ppOutSignature, descreva os parâmetros de entrada e saída, respectivamente, como as propriedades em uma instância IWbemClassObject da classe do sistema _Parameters. As propriedades em ppInSignature são chamadas Paramn, em que n é a posição do parâmetro na assinatura do método (como Param1, Param2 etc.). As propriedades em ppOutSignature também são chamadas Paramn, e o valor retornado é chamado ReturnValue. Para obter mais informações e um exemplo, confira Método IWbemClassObject::GetMethod.

Requisitos

Plataformas: confira Requisitos do sistema.

Header: WMINet_Utils.idl

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

Confira também

WMI e Contadores de Desempenho (Referência de API Não Gerenciada)

Compartilhar via