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

Метод IMbnDeviceService::QueryCommand (mbnapi.h)

  • Статья

Важно!

Начиная с Windows 10 версии 1803, API Win32, описанные в этом разделе, заменяются среда выполнения Windows API в пространстве имен Windows.Networking.Connectivity.

Отправляет команду элемента управления ЗАПРОС в службу устройства мобильной широкополосной связи.

Синтаксис

HRESULT QueryCommand(
  [in]  ULONG     commandID,
  [in]  SAFEARRAY *deviceServiceData,
  [out] ULONG     *requestID
);

Параметры

[in] commandID

Идентификатор команды.

[in] deviceServiceData

Массив байтов, передаваемый на устройство.

[out] requestID

Уникальный идентификатор запроса, назначенный службой мобильной широкополосной связи для идентификации этого запроса.

Возвращаемое значение

Метод может возвращать одно из следующих значений.

Код возврата Описание
S_OK
 Метод завершился успешно.
E_ACCESSDENIED
 Эта команда службы устройств не допускается для вызова привилегий процесса.
Другое
 При выполнении этого метода произошла ошибка.

Комментарии

QueryCommand существует для реализации функциональных возможностей службы устройств для конкретных поставщиков, которые не рассматриваются в API мобильной широкополосной связи. Прежде чем приложение сможет вызвать QueryCommand, необходимо открыть командный сеанс в службе устройства.

Служба мобильной широкополосной связи выдаст запрос ЗАПРОСА на устройство. deviceServiceData будет скопирован по байтам в буфер данных, передаваемый в запрос. Этот буфер данных не должен быть больше байтов MaxCommandSize .

Это асинхронная операция, и QueryCommand возвращается немедленно. После завершения операции служба мобильной широкополосной связи вызовет метод OnQueryCommandComplete интерфейса IMbnDeviceServicesEvents .

Требования

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

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

IMbnDeviceService