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

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

  • Статья

Важно!

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

Отправляет команду управления SET в службу устройства мобильного широкополосного устройства.

Синтаксис

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

Параметры

[in] commandID

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

[in] deviceServiceData

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

[out] requestID

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

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

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

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

Комментарии

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

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

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

Требования

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

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

IMbnDeviceService