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

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

  • Статья

Важно!

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

Сканирует сеть, чтобы получить список видимых поставщиков для устройства с несколькими операторами.

Синтаксис

HRESULT ScanNetwork(
  [out] ULONG *requestID
);

Параметры

[out] requestID

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

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

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

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

Комментарии

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

Это трудоемкая операция. Поэтому приложения должны сначала вызывать GetVisibleProviders , а ScanNetwork следует вызывать только в том случае, если кэшированные сведения устарели.

Это асинхронная операция , и ScanNetwork возвращается немедленно. Если этот метод возвращает успешно (с S_OK), то после завершения операции сканирования операционная система вызовет метод OnScanNetworkCompleteобъекта IMbnMultiCarrierEvents , чтобы уведомить приложение о завершении операции.

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

Требования

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

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

IMbnMultiCarrier