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

O método SendCommand envia um comando WPD padrão e seus parâmetros para o serviço.

Sintaxe

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

Parâmetros

[in] dwFlags

Não usado.

[in] pParameters

A interface IPortableDeviceValues que especifica os parâmetros de comando.

[out] ppResults

A interface IPortableDeviceValues que especifica os resultados do comando.

Valor retornado

Se o método for bem-sucedido, ele retornará S_OK. Qualquer outro valor HRESULT indica que a chamada falhou.

Comentários

Esse método só deve ser usado para enviar comandos WPD padrão para o serviço. Para invocar métodos de serviço, use a interface IPortableDeviceServiceMethods .

Esse método pode falhar mesmo que retorne S_OK como seu valor HRESULT . Para determinar se um comando foi bem-sucedido, um aplicativo sempre deve examinar as propriedades referenciadas pelo parâmetro ppResults :

• A propriedade WPD_PROPERTY_COMMON_HRESULT indica se o comando foi bem-sucedido.
• Se o comando falhar, a propriedade WPD_PROPERTY_COMMON_DRIVER_ERROR_CODE conterá códigos de erro específicos do driver.

O objeto referenciado pelo parâmetro pParameters deve especificar pelo menos estas propriedades:

• WPD_PROPERTY_COMMON_COMMAND_CATEGORY, que deve conter uma categoria de comando, como o membro fmtid da propriedade WPD_COMMAND_COMMON_RESET_DEVICE
• WPD_PROPERTY_COMMON_COMMAND_ID, que deve conter um identificador de comando, como o membro pid da propriedade WPD_COMMAND_COMMON_RESET_DEVICE .

Requisitos

Cliente mínimo com suporte	Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	portabledeviceapi.h

Confira também

IPortableDeviceService Interface