Método IWbemClassObject::GetMethod (wbemcli.h)

  • Artigo

O método IWbemClassObject::GetMethod retorna informações sobre o método solicitado. Essa chamada só terá suporte se o objeto atual for uma definição de classe CIM. As informações do método não estão disponíveis em ponteiros IWbemClassObject que apontam para instâncias CIM.

Sintaxe

HRESULT GetMethod(
  [in]  LPCWSTR          wszName,
  [in]  long             lFlags,
  [out] IWbemClassObject **ppInSignature,
  [out] IWbemClassObject **ppOutSignature
);

Parâmetros

[in] wszName

O nome do método. Isso não pode ser NULL e deve apontar para um LPCWSTR válido.

[in] lFlags

Reservado. Esse parâmetro deve ser 0.

[out] ppInSignature

Um ponteiro que recebe um ponteiro IWbemClassObject que descreve o nos parâmetros para o método . Esse parâmetro será ignorado se definido como NULL. Lembre-se de que o Gerenciamento do Windows pode definir o ponteiro IWbemClassObject como NULL se esse método não tiver parâmetros em . Para obter mais informações, consulte Comentários.

[out] ppOutSignature

Um ponteiro que recebe um ponteiro IWbemClassObject que descreve os parâmetros externos para o método . Esse parâmetro será ignorado se definido como NULL.

Retornar valor

Esse método retorna um HRESULT que indica o status da chamada de método. A lista a seguir lista o valor contido em um HRESULT. Para obter valores gerais de HRESULT , consulte Códigos de erro do sistema.

Comentários

Para um método , os parâmetros de entrada e saída são descritos como propriedades em um IWbemClassObject, uma instância da classe do sistema __Parameters.

Por exemplo, considere o seguinte método:

Class MyClass{
    [key] string KeyVal;
    sint32 PropVal;
    sint32 ExampleMethod([in] sint32 Parm1, [in] uint32 Parm2, 
      [out] string Parm3);
};

Neste exemplo, a classe tem um único método. Quando o usuário chama IWbemClassObject::GetMethod, o parâmetro ppInSignature recebe um objeto IWbemClassObject , que contém duas propriedades: Parm1 e Parm2. O parâmetro ppOutSignature contém duas propriedades, Parm3 e ReturnValue.

Depois de preencher os valores de propriedade do objeto ppInSignature , o chamador pode usar o objeto para executar o método chamando IWbemServices::ExecMethod ou IWbemServices::ExecMethodAsync.

Nota O chamador deve chamar IWbemClassObject::Release nos ponteiros ppInSignature e ppOutSignature quando esses objetos não forem mais necessários.
 

Requisitos

   
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho wbemcli.h (include Wbemidl.h)
Biblioteca WbemUuid.lib
DLL CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll

Confira também

IWbemClassObject

IWbemClassObject::P utMethod