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

Метод IMbnServiceActivationEvents::OnActivationComplete (mbnapi.h)

  • Статья

Важно!

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

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

Синтаксис

HRESULT OnActivationComplete(
  [in] IMbnServiceActivation *serviceActivation,
  [in] SAFEARRAY             *vendorSpecificData,
  [in] ULONG                 requestID,
  [in] HRESULT               status,
  [in] ULONG                 networkError
);

Параметры

[in] serviceActivation

Указатель на интерфейс IMbnServiceActivation , представляющий устройство, на котором был выполнен запрос.

[in] vendorSpecificData

Массив байтов, содержащий данные, возвращаемые базовым драйвером мини-порта мобильной широкополосной связи в NDIS_STATUS_WWAN_SERVICE_ACTIVATION.

[in] requestID

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

[in] status

Состояние завершения.

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

Значение Значение
S_OK
 Операция выполнена успешно.
E_INVALIDARG
 Драйвер мини-порта обнаружил неверные входные данные в запросе.
E_MBN_PIN_REQUIRED
 Для завершения операции требуется ПИН-код.
E_MBN_RADIO_POWER_OFF
 Мобильное широкополосное устройство не выключено.
E_MBN_PROVIDER_NOT_VISIBLE
 Поставщик услуг не виден.
E_MBN_SIM_NOT_INSERTED
 На устройстве нет SIM-карты.
E_MBN_BAD_SIM
 На устройстве есть неправильная SIM-карта.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 Устройство не поддерживает эту операцию.

[in] networkError

Код ошибки, возвращенный сетью во время операции активации. Это значение имеет смысл, только если состояние не S_OK.

Точное значение networkError зависит от драйвера или сети.

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

Этот метод должен возвращать S_OK.

Комментарии

Успешная активация службы также приведет к изменению состояния готовности устройства. Служба мобильной широкополосной связи вызовет метод OnReadyStateChangeобъекта IMbnInterfaceEvents в качестве уведомления.

Требования

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

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

IMbnServiceActivationEvents