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.
- 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 |