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

Метод IMbnConnectionContextEvents::OnSetProvisionedContextComplete (mbnapi.h)

  • Статья

Важно!

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

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

Синтаксис

HRESULT OnSetProvisionedContextComplete(
  [in] IMbnConnectionContext *newInterface,
  [in] ULONG                 requestID,
  [in] HRESULT               status
);

Параметры

[in] newInterface

Интерфейс IMbnConnectionContext , представляющий устройство, для которого задан контекст.

[in] requestID

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

[in] status

Код состояния, указывающий результат операции.

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

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

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

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

Комментарии

Вызывающее приложение может передать интерфейс IMbnConnectionContextв newInterface , чтобы получить обновленный список подготовленных контекстов на устройстве. Но так как эта операция является асинхронной, приложение должно дождаться уведомления OnProvisionedContextListChange , прежде чем использовать этот интерфейс для получения контекстов.

Если для получения уведомлений зарегистрировано несколько приложений, все они получат это уведомление, хотя только одно из них могло инициировать эту операцию.

Требования

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

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

IMbnConnectionContextEvents