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

Метод IMbnConnection::Connect (mbnapi.h)

  • Статья

Важно!

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

Устанавливает подключение к данным.

Синтаксис

HRESULT Connect(
  [in]  MBN_CONNECTION_MODE connectionMode,
  [in]  LPCWSTR             strProfile,
  [out] ULONG               *requestID
);

Параметры

[in] connectionMode

Значение MBN_CONNECTION_MODE , указывающее режим соединения.

[in] strProfile

Содержит конструктор профиля.

[out] requestID

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

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

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

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

Комментарии

Метод Connect используется для активации контекста подключения для устройства. Служба мобильной широкополосной связи в настоящее время поддерживает не более одного активного контекста. Активация контекста также приведет к установлению подключения L2. Аналогичным образом деактивация контекста приведет к отключению подключения физических данных к мобильной сети.

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

Если параметр connectionMode имеет значение MBN_CONNECTION_MODE_PROFILE, то strProfile представляет имя профиля для устройства. Если задано значение MBN_CONNECTION_MODE_TMP_PROFILE, то strProfile представляет XML-представление профиля. Вызывающее приложение может использовать IMbnConnectionProfileManager для получения списка профилей подключений, хранящихся на устройстве.

Это асинхронная операция, которая возвращается немедленно. Если этот метод возвращает успешно, служба мобильной широкополосной связи вызовет метод OnConnectCompleteобъекта IMbnConnectionEvents после завершения операции.

Windows 8 и более поздних версий Windows. Приложение Магазина Windows может использовать Connect только с MBN_CONNECTION_MODE_TMP_PROFILEconnectionMode и параметром strProfile , установленным в XML-представление профиля. Это означает, что подключение носит временный характер и не сохраняется для дальнейшего использования системой.

Требования

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

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

IMbnConnection