Metodo IPortableDeviceService::SendCommand (portabledeviceapi.h)

Articolo
08/25/2023

Il metodo SendCommand invia un comando WPD standard e i relativi parametri al servizio.

Sintassi

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

Parametri

[in] dwFlags

Non usato.

[in] pParameters

Interfaccia IPortableDeviceValues che specifica i parametri del comando.

[out] ppResults

Interfaccia IPortableDeviceValues che specifica i risultati del comando.

Valore restituito

Se il metodo ha esito positivo, restituisce S_OK. Qualsiasi altro valore HRESULT indica che la chiamata non è riuscita.

Commenti

Questo metodo deve essere usato solo per inviare comandi WPD standard al servizio. Per richiamare i metodi del servizio, usare l'interfaccia IPortableDeviceServiceMethods .

Questo metodo può avere esito negativo anche se restituisce S_OK come valore HRESULT . Per determinare se un comando ha esito positivo, un'applicazione deve sempre esaminare le proprietà a cui fa riferimento il parametro ppResults :

La proprietà WPD_PROPERTY_COMMON_HRESULT indica se il comando è riuscito.
Se il comando non è riuscito, la proprietà WPD_PROPERTY_COMMON_DRIVER_ERROR_CODE conterrà codici di errore specifici del driver.

L'oggetto a cui fa riferimento il parametro pParameters deve specificare almeno queste proprietà:

WPD_PROPERTY_COMMON_COMMAND_CATEGORY, che deve contenere una categoria di comandi, ad esempio il membro fmtid della proprietà WPD_COMMAND_COMMON_RESET_DEVICE
WPD_PROPERTY_COMMON_COMMAND_ID, che deve contenere un identificatore di comando, ad esempio il membro pid della proprietà WPD_COMMAND_COMMON_RESET_DEVICE .

Requisiti


Client minimo supportato	Windows 7 [app desktop \| App UWP]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	portabledeviceapi.h

Vedi anche

Interfaccia IPortableDeviceService