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


Метод IMbnConnectionEvents::OnConnectComplete (mbnapi.h)

Важно!

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

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

Синтаксис

HRESULT OnConnectComplete(
  [in] IMbnConnection *newConnection,
  [in] ULONG          requestID,
  [in] HRESULT        status
);

Параметры

[in] newConnection

Интерфейс IMbnConnection , представляющий устройство, на котором выполнена операция подключения.

[in] requestID

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

[in] status

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

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

Значение Значение
S_OK
Операция выполнена успешно.
E_MBN_SIM_NOT_INSERTED
На устройстве нет SIM-карты.
E_MBN_PIN_REQUIRED
Для завершения операции требуется ПИН-код.
E_MBN_SERVICE_NOT_ACTIVATED
Срок действия подписки на сетевую службу истек.
E_MBN_PROVIDER_NOT_VISIBLE
Поставщик не виден. Это относится только к режиму регистрации вручную.
E_MBN_INVALID_ACCESS_STRING
Строка доступа к подключению указана неправильно.
HRESULT_FROM_WIN32(ERROR_INVALID_PASSWORD)
Имя или пароль, которые используются в профиле подключения, неверны.
E_MBN_VOICE_CALL_IN_PROGRESS
Выполняется активный голосовой звонок.
E_MBN_MAX_ACTIVATED_CONTEXTS
Уже существует активный контекст мобильной широкополосной связи. Служба мобильной широкополосной связи в настоящее время не поддерживает несколько активных контекстов.
E_MBN_RADIO_POWER_OFF
Радиоустройство выключено.
E_MBN_PACKET_SVC_DETACHED
Активная подключенная служба пакетов недоступна.
E_MBN_ACTIVE_CONNECTION
Устройство уже подключено к сети.

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

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

Комментарии

После установки контекста активации приложение может использовать IMbnConnection для получения текущего состояния подключения.

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

Требования

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

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

IMbnConnectionEvents