次の方法で共有


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 に設定して、これを同期呼び出しにすることができます。 これを半同期呼び出しにするには、 lFlagsWBEM_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 固有のエラー コードも返される可能性があります。

解説

ppOutParamsNULL でない場合、クライアントは 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