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

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

  • Статья

Важно!

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

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

Синтаксис

HRESULT ScanNetwork(
  [out] ULONG *requestID
);

Параметры

[out] requestID

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

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

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

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

Комментарии

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

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

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

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

Требования

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

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

IMbnInterface