Поделиться через

Метод 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 будет содержать коды ошибок, относящихся к конкретному драйверу.
Объект, на который ссылается параметр pParameters , должен указывать по крайней мере следующие свойства:

Требования

   
Минимальная версия клиента Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header portabledeviceapi.h

См. также раздел

Интерфейс IPortableDeviceService