Método IPortableDeviceService::SendCommand (portabledeviceapi.h)

El método SendCommand envía un comando WPD estándar y sus parámetros al servicio.

Sintaxis

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

Parámetros

[in] dwFlags

No se usa.

[in] pParameters

Interfaz IPortableDeviceValues que especifica los parámetros de comando.

[out] ppResults

Interfaz IPortableDeviceValues que especifica los resultados del comando.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Cualquier otro valor HRESULT indica que se produjo un error en la llamada.

Comentarios

Este método solo se debe usar para enviar comandos WPD estándar al servicio. Para invocar métodos de servicio, use la interfaz IPortableDeviceServiceMethods .

Este método puede producir un error aunque devuelva S_OK como su valor HRESULT . Para determinar si un comando se realizó correctamente, una aplicación siempre debe examinar las propiedades a las que hace referencia el parámetro ppResults :

• La propiedad WPD_PROPERTY_COMMON_HRESULT indica si el comando se realizó correctamente.
• Si se produce un error en el comando, la propiedad WPD_PROPERTY_COMMON_DRIVER_ERROR_CODE contendrá códigos de error específicos del controlador.

El objeto al que hace referencia el parámetro pParameters debe especificar al menos estas propiedades:

• WPD_PROPERTY_COMMON_COMMAND_CATEGORY, que debe contener una categoría de comando, como el miembro fmtid de la propiedad WPD_COMMAND_COMMON_RESET_DEVICE
• WPD_PROPERTY_COMMON_COMMAND_ID, que debe contener un identificador de comando, como el miembro pid de la propiedad WPD_COMMAND_COMMON_RESET_DEVICE .

Requisitos

Cliente mínimo compatible	Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	portabledeviceapi.h

Consulte también

IPortableDeviceService (Interfaz)