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 を呼び出すことによって、 オブジェクトを使用してメソッドを実行できます。
要件
| サポートされている最小のクライアント | 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 |