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

Метод IMbnConnectionContext::SetProvisionedContext (mbnapi.h)

  • Статья

Важно!

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

Добавляет или обновляет подготовленный контекст.

Синтаксис

HRESULT SetProvisionedContext(
  [in]  MBN_CONTEXT provisionedContexts,
  [in]  LPCWSTR     providerID,
  [out] ULONG       *requestID
);

Параметры

[in] provisionedContexts

Структура MBN_CONTEXT , указывающая подготовленный контекст, который будет храниться на устройстве или SIM-карте.

[in] providerID

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

[out] requestID

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

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

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

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

Комментарии

ContextIDобъекта provisionedContexts указывает индекс в памяти устройства или SIM-карты, в которой должен храниться контекст. Если задано значение MBN_CONTEXT_ID_APPEND, устройство должно найти соответствующий индекс для хранения контекста.

Это асинхронная операция , и SetProvisionedContext возвращается немедленно. После завершения операции служба мобильной широкополосной связи уведомит приложение, вызвав метод OnSetProvisionedContextCompleteобъекта IMbnConnectionContextEvents.

Дополнения к подготовленному списку контекста для текущего идентификатора домашнего поставщика не будут доступны для запроса, пока не будет вызван метод OnProvisionedContextListChangeIMbnConnectionContextEvents .

Требования

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

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

IMbnConnectionContext