IWbemClassObject::GetMethod メソッド (wbemcli.h)

IWbemClassObject::GetMethod メソッドは、要求されたメソッドに関する情報を返します。 この呼び出しは、現在のオブジェクトが CIM クラス定義である場合にのみサポートされます。 CIM インスタンスを指す IWbemClassObject ポインターからメソッド情報を取得することはできません。

構文

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

パラメーター

[in] wszName

メソッド名。 これは NULL にすることはできません。有効な LPCWSTR を指す必要があります。

[in] lFlags

予約済み。 このパラメーターは、0 にする必要があります。

[out] ppInSignature

メソッドへの in パラメーターを記述する IWbemClassObject ポインターを受け取るポインター。 NULL に設定されている場合、このパラメーターは無視されます。 このメソッドにパラメーターがない場合、Windows Management は IWbemClassObject ポインターを NULL に設定できることに注意してください。 詳細については、「解説」を参照してください。

[out] ppOutSignature

メソッドへの出力パラメーターを記述する IWbemClassObject ポインターを受け取るポインター。 NULL に設定されている場合、このパラメーターは無視されます。

戻り値

このメソッドは、メソッド呼び出しの状態を示す HRESULT を返します。 次の一覧は、 HRESULT 内に含まれる値の一覧です。 一般的な HRESULT 値については、「 システム エラー コード」を参照してください。

解説

メソッドの場合、in パラメーターと out パラメーターは、システム クラスのインスタンスである IWbemClassObject のプロパティとして 記述__Parameters。

たとえば、次の方法を考えてみましょう。

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

この例では、 クラスには 1 つのメソッドがあります。 ユーザーが IWbemClassObject::GetMethod を呼び出すと、ppInSignature パラメーターは、Parm1 と Parm2 の 2 つのプロパティを含む IWbemClassObject オブジェクトを受け取ります。 ppOutSignature パラメーターには、Parm3 と ReturnValue の 2 つのプロパティが含まれています。

ppInSignature オブジェクトのプロパティ値を入力した後、呼び出し元は IWbemServices::ExecMethod または IWbemServices::ExecMethodAsync を呼び出すことによって、 オブジェクトを使用してメソッドを実行できます。

メモ呼び出し元は、これらのオブジェクトが不要になったときに、ppInSignature ポインターと ppOutSignature ポインターで IWbemClassObject::Release を呼び出す必要があります。

 

要件

サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
対象プラットフォーム	Windows
ヘッダー	wbemcli.h (Wbemidl.h を含む)
Library	WbemUuid.lib
[DLL]	CIMWin32.dll;Esscli.dll;Fastprox.dll;FrameDyn.dll;FrameDynOS.dll;Krnlprov.dll;Ncprov.dll;Wbemcore.dll;Wbemess.dll;Wmipiprt.dll

関連項目

IWbemClassObject

IWbemClassObject::P utMethod