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 接口。

即使此方法返回 S_OK 作为其 HRESULT 值，此方法也可能失败。 若要确定命令是否成功，应用程序应始终检查 ppResults 参数引用的属性：

• WPD_PROPERTY_COMMON_HRESULT 属性指示命令是否成功。
• 如果命令失败， WPD_PROPERTY_COMMON_DRIVER_ERROR_CODE 属性将包含特定于驱动程序的错误代码。

pParameters 参数引用的对象必须至少指定以下属性：

• WPD_PROPERTY_COMMON_COMMAND_CATEGORY，应包含命令类别，例如 WPD_COMMAND_COMMON_RESET_DEVICE 属性的 fmtid 成员
• WPD_PROPERTY_COMMON_COMMAND_ID，应包含命令标识符，例如 WPD_COMMAND_COMMON_RESET_DEVICE 属性的 pid 成员。

要求

最低受支持的客户端	Windows 7 [桌面应用 |UWP 应用]
最低受支持的服务器	无受支持的版本
目标平台	Windows
标头	portabledeviceapi.h

请参阅

IPortableDeviceService 接口