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

関連項目

メソッドの呼び出し

IWbemCallResult::GetResultObject

IWbemServices

IWbemServices::ExecMethodAsync