Метод 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 |