Метод IMbnConnectionContext::GetProvisionedContexts (mbnapi.h)
Важно!
Начиная с Windows 10 версии 1803 API Win32, описанные в этом разделе, заменяются API среда выполнения Windows в пространстве имен Windows.Networking.Connectivity.
Возвращает список контекстов подключения.
Синтаксис
HRESULT GetProvisionedContexts(
[out, retval] SAFEARRAY **provisionedContexts
);
Параметры
[out, retval] provisionedContexts
Список MBN_CONTEXT значений, представляющих контексты подключения, хранящиеся на устройстве. При ошибке этот массив имеет значение NULL. В случае успешного выполнения вызывающее приложение должно освободить выделенную память, вызвав SafeArrayDeки.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
| Код возврата | Описание |
|---|---|
|
Метод завершился успешно. |
|
Контексты подключения недоступны. Служба мобильной широкополосной связи проверит устройство на наличие информации. Вызывающее приложение может получать уведомления о доступности контекстов подключения, зарегистрировав метод OnProvisionedContextListChangeобъекта IMbnConnectionContextEvents. |
|
Для получения контекстов подключения требуется ПИН-код. |
|
SIM-карта не вставляется в устройство. |
|
В устройство вставляется неправильная SIM-карта. |
|
Устройство не поддерживает получение подготовленных контекстов. |
Комментарии
Контекст подключения — это абстракция определенного набора параметров конфигурации сети для настройки виртуального канала или потока поверх физического широкополосного подключения мобильной связи на уровне 2. В GSM это соответствует понятию контекста PDP; в CDMA он соответствует сетевому профилю.
В некоторых случаях параметры подключения уже доступны в памяти устройства или SIM-карты. Этот метод можно использовать для получения списка сохраненных контекстов подключения, хранящихся на устройстве для текущей сети домашнего поставщика.
Для создания подключений к данным следует использовать только контексты типа MBN_CONTEXT_TYPE_INTERNET .
Устройство вернет все сохраненные контексты для текущего поставщика домашней страницы. Некоторые контексты могут быть пустыми, и они будут сообщаться как MBN_CONTEXT_TYPE_NONE.
Иногда сохраненные подготовленные контексты могут быть обновлены сетью с помощью SMS или OTA. При изменении контекстов, подготовленных устройством, служба мобильной широкополосной связи будет вызывать метод OnProvisionedContextListChangeIMbnConnectionContextEvents. Затем приложение может использовать этот метод для получения обновленного списка подготовленных контекстов.
Для ошибок, которые можно исправить E_MBN_PIN_REQUIRED, E_MBN_SIM_NOT_INSERTED и E_MBN_BAD_SIM, служба мобильного широкополосного подключения снова запросит эти сведения у устройства после завершения состояния ошибки. Например, если устройству требуется ввести ПИН-код для получения контекстов подключения, оно вернет E_MBN_PIN_REQUIRED. Когда приложение вводит ПИН-код для разблокировки устройства, служба снова попытается получить эти сведения с устройства. Служба обновит приложение о состоянии нового запроса, вызвав метод OnProvisionedContextListChangeобъекта IMbnConnectionContextEvents.
Требования
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Целевая платформа | Windows |
| Header | mbnapi.h |