Метод IPortableDeviceService::SendCommand (portabledeviceapi.h)

Статья
08/25/2023

Метод 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 указывает, что вызов завершился сбоем.

Этот метод может завершиться ошибкой, даже если он возвращает S_OK в качестве значения HRESULT . Чтобы определить, успешно ли выполнена команда, приложение всегда должно проверять свойства, на которые ссылается параметр ppResults :

Свойство WPD_PROPERTY_COMMON_HRESULT указывает, выполнена ли команда.
Если команда не выполнена, свойство WPD_PROPERTY_COMMON_DRIVER_ERROR_CODE будет содержать коды ошибок, относящихся к конкретному драйверу.

Объект, на который ссылается параметр pParameters , должен указывать по крайней мере следующие свойства:

WPD_PROPERTY_COMMON_COMMAND_CATEGORY, который должен содержать категорию команд, например элемент fmtid свойства WPD_COMMAND_COMMON_RESET_DEVICE .
WPD_PROPERTY_COMMON_COMMAND_ID, который должен содержать идентификатор команды, например элемент pid свойства WPD_COMMAND_COMMON_RESET_DEVICE .

Требования


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

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

Интерфейс IPortableDeviceService

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