IWbemClassObject::GetMethod-Methode (wbemcli.h)

  • Artikel

Die IWbemClassObject::GetMethod-Methode gibt Informationen zur angeforderten Methode zurück. Dieser Aufruf wird nur unterstützt, wenn das aktuelle Objekt eine CIM-Klassendefinition ist. Methodeninformationen sind von IWbemClassObject-Zeigern , die auf CIM-Instanzen verweisen, nicht verfügbar.

Syntax

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

Parameter

[in] wszName

Der Methodenname. Dies darf nicht NULL sein und muss auf einen gültigen LPCWSTR verweisen.

[in] lFlags

Reserviert. Dieser Parameter muss 0 sein.

[out] ppInSignature

Ein Zeiger, der einen IWbemClassObject-Zeiger empfängt, der die in -Parameter für die -Methode beschreibt. Dieser Parameter wird ignoriert, wenn er auf NULL festgelegt ist. Beachten Sie, dass die Windows-Verwaltung den IWbemClassObject-Zeiger auf NULL festlegen kann, wenn diese Methode keine Parameter enthält. Weitere Informationen finden Sie in den Hinweisen.

[out] ppOutSignature

Ein Zeiger, der einen IWbemClassObject-Zeiger empfängt , der die Out-Parameter für die -Methode beschreibt. Dieser Parameter wird ignoriert, wenn er auf NULL festgelegt ist.

Rückgabewert

Diese Methode gibt ein HRESULT zurück, das den Status des Methodenaufrufs angibt. In der folgenden Liste ist der in einem HRESULT enthaltene Wert aufgeführt. Allgemeine HRESULT-Werte finden Sie unter Systemfehlercodes.

Hinweise

Für eine Methode werden die Parameter in und out als Eigenschaften in einem IWbemClassObject beschrieben, einem instance der Systemklasse __Parameters.

Betrachten Sie beispielsweise die folgende Methode:

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

In diesem Beispiel verfügt die -Klasse über eine einzelne Methode. Wenn der Benutzer IWbemClassObject::GetMethodaufruft, empfängt der ppInSignature-Parameter ein IWbemClassObject-Objekt , das zwei Eigenschaften enthält: Parm1 und Parm2. Der ppOutSignature-Parameter enthält zwei Eigenschaften: Parm3 und ReturnValue.

Nach dem Ausfüllen der Eigenschaftswerte des ppInSignature-Objekts kann der Aufrufer das -Objekt verwenden, um die -Methode auszuführen, indem er IWbemServices::ExecMethod oder IWbemServices::ExecMethodAsync aufruft.

Hinweis Der Aufrufer muss IWbemClassObject::Release für die Zeiger ppInSignature und ppOutSignature aufrufen, wenn diese Objekte nicht mehr benötigt werden.
 

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile wbemcli.h (include Wbemidl.h)
Bibliothek WbemUuid.lib
DLL CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll

Weitere Informationen

IWbemClassObject

IWbemClassObject::P utMethod