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

Метод IMbnMultiCarrier::SetHomeProvider (mbnapi.h)

  • Статья

Важно!

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

Обновления домашнего поставщика для устройства с несколькими носителями.

Синтаксис

HRESULT SetHomeProvider(
  [in]  MBN_PROVIDER2 *homeProvider,
  [out] ULONG         *requestID
);

Параметры

[in] homeProvider

Структура MBN_PROVIDER2 , содержащая домашнего поставщика.

Примечание  

Элементы SignalStrength и SignalError должны иметь значение 0.

 

[out] requestID

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

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

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

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

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

Комментарии

Метод SetHomeProvider инициирует обновление домашнего поставщика для интерфейса. Это асинхронная операция, и вызов метода возвращается немедленно. Если этот метод успешно возвращает S_OK, Windows уведомит вызывающее приложение о состоянии завершения этой операции, вызвав метод OnSetHomeProviderCompleteобъекта IMbnMultiCarrierEvents.

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

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

Требования

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

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

IMbnMultiCarrier