IPortableDeviceService::SendCommand メソッド (portabledeviceapi.h)

SendCommand メソッドは、標準の WPD コマンドとそのパラメーターをサービスに送信します。

構文

HRESULT SendCommand(
  [in]  const DWORD           dwFlags,
  [in]  IPortableDeviceValues *pParameters,
  [out] IPortableDeviceValues **ppResults
);

[in] dwFlags

使用しません。

[in] pParameters

コマンドパラメーターを指定する IPortableDeviceValues インターフェイス。

[out] ppResults

コマンドの結果を指定する IPortableDeviceValues インターフェイス。

メソッドが成功すると、 S_OKが返されます。その他の HRESULT 値は、呼び出しが失敗したことを示します。

このメソッドは、標準の WPD コマンドをサービスに送信する場合にのみ使用する必要があります。サービスメソッドを呼び出すには、 IPortableDeviceServiceMethods インターフェイスを使用します。

このメソッドは、HRESULT 値としてS_OKを返しても失敗する可能性があります。コマンドが成功したかどうかを判断するには、アプリケーションで 常に ppResults パラメーターによって参照されるプロパティを調べる必要があります。

pParameters パラメーターによって参照されるオブジェクトは、少なくとも次のプロパティを指定する必要があります。

WPD_PROPERTY_COMMON_COMMAND_CATEGORY。コマンドカテゴリ (WPD_COMMAND_COMMON_RESET_DEVICE プロパティの fmtid メンバーなど) を含める必要があります
WPD_PROPERTY_COMMON_COMMAND_ID。コマンド識別子 (WPD_COMMAND_COMMON_RESET_DEVICE プロパティの pid メンバーなど) を含める必要があります。