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

Метод IMbnServiceActivation::Activate (mbnapi.h)

  • Статья

Важно!

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

Отправьте запрос на активацию службы в сеть.

Синтаксис

HRESULT Activate(
  [in]  SAFEARRAY *vendorSpecificData,
  [out] ULONG     *requestID
);

Параметры

[in] vendorSpecificData

Зависящий от поставщика массив байтов, передаваемый в операции активации службы. Эти данные будут переданы службой мобильной широкополосной связи в запросе SET OID_WWAN_SERVICE_ACTIVATION OID драйверу мини-порта.

[out] requestID

Идентификатор запроса для этой операции.

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

Этот метод может возвращать одно из этих значений.

Код возврата Описание
S_OK
 Метод завершился успешно.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)
 Служба мобильного широкополосного подключения не работает в этой системе.
E_HANDLE
 Недопустимый интерфейс. Скорее всего, устройство было удалено из системы.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
 Недопустимый интерфейс. Скорее всего, мобильное широкополосное устройство было удалено из системы.

Недопустимый интерфейс. Скорее всего, устройство было удалено из системы.

Комментарии

Метод Activate может использоваться приложением для активации сотовой службы. Формат данных, передаваемых в этом запросе, зависит от поставщика.

Поле VendorSpecificBufferSize запроса OID будет иметь размер данных в SAFEARRAY, vendorSpecificData. Содержимое vendorSpecificData будет скопировано по байтам в запросе OID к драйверу.

Дополнительные сведения об операциях активации служб см. в разделе Модель драйвера мобильной широкополосной связи.

Это асинхронная операция, которая возвращается немедленно. Если метод возвращает без ошибок, служба мобильного широкополосного подключения вызовет метод OnActivationComplete интерфейса IMbnServiceActivationEvents .

Требования

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

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

IMbnServiceActivation