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 介面