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 屬性將包含驅動程式特定的錯誤碼。
- 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 |