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

Метод IMbnInterfaceEvents::OnSetPreferredProvidersComplete (mbnapi.h)

  • Статья

Важно!

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

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

Синтаксис

HRESULT OnSetPreferredProvidersComplete(
  [in] IMbnInterface *newInterface,
  [in] ULONG         requestID,
  [in] HRESULT       status
);

Параметры

[in] newInterface

Интерфейс IMbnInterface, представляющий устройство, на котором выполнялась эта операция.

[in] requestID

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

[in] status

Состояние завершения операции.

В следующей таблице перечислены допустимые значения для этого состояния.

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

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

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

Комментарии

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

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

Если вызов метода SetPreferredProvidersIMbnInterface приводит к изменению списка предпочтительных поставщиков, метод OnPreferredProvidersChangeобъекта IMbnInterfaceEvents вызываться не будет.

Требования

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

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

IMbnInterfaceEvents