Função GetMethod

Artigo
05/09/2023

Obtém informações sobre o método especificado.

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 GetMethod (
   [in] int                vFunc,
   [in] IWbemClassObject*   ptr,
   [in] LPCWSTR             wszName,
   [in] LONG                lFlags,
   [out] IWbemClassObject** ppInSignature,
   [out] IWbemClassObject** ppOutSignature
);

Parâmetros

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

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

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

lFlags
[in] Reservado. Este parâmetro tem de ser 0.

ppInSignature
[fora] Um ponteiro para o endereço de uma instância IWbemClassObject que descreve os parâmetros in para o método . Este parâmetro é ignorado se estiver definido como null.

ppOutSignature
[fora] Um ponteiro para o endereço de uma instância IWbemClassObject que descreve os parâmetros de saída para o método . Este parâmetro é ignorado se estiver definido como null.

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	A propriedade especificada não foi encontrada.
`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::GetMethod .

A Gestão do Windows pode definir o ponteiro IWbemClassObject como null se o método não tiver parâmetros.

In ppInSignature and ppOutSignature describe in and out parameters, respectively, as properties in IWbemClassObject a instance of the system class _Parameters. As propriedades em ppInSignature são denominadas 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 têm o nome Paramn e o valor devolvido é denominado ReturnValue. Para obter mais informações e um exemplo, veja Método IWbemClassObject::GetMethod.

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

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

Partilhar via