IWbemServices::ExecMethod メソッド (wbemcli.h)
IWbemServices::ExecMethod メソッドは、CIM オブジェクトによってエクスポートされたメソッドを実行します。 メソッド呼び出しは、実行先の適切なプロバイダーに転送されます。 情報と状態が呼び出し元に返され、呼び出しが完了するまでブロックされます。
メソッドは Windows Management によって直接実装されるのではなく、メソッド プロバイダーによってエクスポートされます。 任意の CIM クラスについて、使用可能なメソッドとそのパラメーターは、該当するプロバイダーのドキュメントで指定する必要があります。
メソッドの実行の詳細については、「メソッドの 呼び出し」を参照してください。
構文
HRESULT ExecMethod(
[in] const BSTR strObjectPath,
[in] const BSTR strMethodName,
[in] long lFlags,
[in] IWbemContext *pCtx,
[in] IWbemClassObject *pInParams,
[out] IWbemClassObject **ppOutParams,
[out] IWbemCallResult **ppCallResult
);
パラメーター
[in] strObjectPath
メソッドが実行されるオブジェクトのオブジェクト パスを含む有効な BSTR。
[in] strMethodName
オブジェクトのメソッドの名前。
[in] lFlags
このパラメーターを 0 に設定して、これを同期呼び出しにすることができます。 これを半同期呼び出しにするには、 lFlags を WBEM_FLAG_RETURN_IMMEDIATELY に設定し、 ppCallResult パラメーターに有効なポインターを指定すると、この呼び出しはすぐに返されます。 詳細については、「メソッドの呼び出し」を参照してください。
[in] pCtx
通常 は NULL です。それ以外の場合、これは メソッドを実行しているプロバイダーによって使用される可能性がある IWbemContext オブジェクトへのポインターです。 コンテキスト オブジェクトの値は、該当するプロバイダーのドキュメントで指定する必要があります。 このパラメーターの詳細については、「 WMI への呼び出しの作成」を参照してください。
[in] pInParams
メソッドの実行にインパラメーターが必要ない場合は NULL を指定できます。 それ以外の場合は、メソッド実行の受信パラメーターとして機能するプロパティを含む IWbemClassObject を指します。 オブジェクトの内容はメソッド固有であり、問題のプロバイダーの仕様の一部です。 入力パラメーターの作成の詳細については、「 C++ でのパラメーター オブジェクトの作成」を参照してください。
[out] ppOutParams
NULL でない場合は、送信パラメーターへのポインターを受け取り、メソッド実行の値を返します。 このオブジェクトの内容はメソッド固有であり、問題のプロバイダーの仕様の一部です。 呼び出し元は、不要になったら、返されたオブジェクトで Release を呼び出す必要があります。
[out] ppCallResult
NULL の場合、これは使用されません。 ppCallResult を指定する場合は、エントリで NULL をポイントするように設定する必要があります。 この場合、呼び出しは WBEM_S_NO_ERROR を 使用して直ちにを返します。 ppCallResult パラメーターは、新しい IWbemCallResult オブジェクトへのポインターを受け取ります。このオブジェクトは、GetCallStatus メソッドを使用してメソッド実行の結果を取得するためにポーリングする必要があります。 呼び出しの out パラメーターは、 IWbemCallResult::GetResultObject を呼び出すことによって使用できます。
戻り値
このメソッドは、メソッド呼び出しの状態を示す HRESULT を返します。 次の一覧は、 HRESULT 内に含まれる値の一覧です。
失敗した場合は、COM 関数 GetErrorInfo から使用可能な情報を取得できます。
ネットワークの問題によって Windows Management へのリモート接続が失われると、COM 固有のエラー コードも返される可能性があります。
解説
ppOutParams が NULL でない場合、クライアントは ppOutParams が指すオブジェクトの ReturnValue プロパティを調べることで、メソッドの戻り値の型を確認できます。
要件
サポートされている最小のクライアント | Windows Vista |
サポートされている最小のサーバー | Windows Server 2008 |
対象プラットフォーム | Windows |
ヘッダー | wbemcli.h (Wbemidl.h を含む) |
Library | Wbemuuid.lib |
[DLL] | Fastprox.dll;Esscli.dll;FrameDyn.dll;FrameDynOS.dll;Ntevt.dll;Stdprov.dll;Viewprov.dll;Wbemcomn.dll;Wbemcore.dll;Wbemess.dll;Wbemsvc.dll;Wmipicmp.dll。Wmidcprv.dll;Wmipjobj.dll。Wmiprvsd.dll |