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

Важно!

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

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

Синтаксис

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

Параметры

[in] newInterface

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

[in] requestID

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

[in] status

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

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

S_OK

Операция выполнена успешно.

E_MBN_RADIO_POWER_OFF

Не удается получить видимый список сети, так как радиоустройство выключено. Приложение может выдать запрос на сканирование сети при получении уведомления о включении переключателя.

E_MBN_DEVICE_BUSY

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

E_MBN_ALREADY_ACTIVE

Операция сканирования сети уже выполняется.

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

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

Комментарии

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

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

Требования

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

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

События IMbnInterfaceEvents