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

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

  • Статья

Важно!

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

Возвращает список видимых поставщиков.

Синтаксис

HRESULT GetVisibleProviders(
  [out, retval] ULONG     *age,
  [out, retval] SAFEARRAY **visibleProviders
);

Параметры

[out, retval] age

Указатель на время в секундах с момента последнего обновления видимого списка поставщиков с устройства.

[out, retval] visibleProviders

Указатель на массив структур MBN_PROVIDER , содержащий список поставщиков для интерфейса. Если этот метод возвращает любое значение, отличное от S_OK, этот параметр имеет значение NULL. В противном случае по завершении вызывающая программа должна освободить выделенную память, вызвав SafeArrayDeки.

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

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

Код возврата Описание
S_OK
 Метод завершился успешно. visibleProviders содержит допустимые значения. В зависимости от возраста информации вызывающее приложение может решить выполнить новый вызов ScanNetwork.
E_PENDING
 Сведения недоступны. Выполняется активное сканирование сети. Вызывающее приложение может получать уведомления о доступности возможностей устройства, зарегистрировав метод OnScanNetworkCompleteобъекта IMbnInterfaceEvents.
E_MBN_INVALID_CACHE
 Кэш видимого списка сетей мобильной широкополосной связи недопустим. Вызывающее приложение должно вызвать ScanNetwork для заполнения кэша.

Комментарии

Этот метод возвращает список видимых в настоящее время поставщиков. Устройства CDMA будут сообщать только о своем домашнем поставщике, если доступна какая-либо сеть из предпочтительного списка роуминга (PRL).

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

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

Требования

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

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

IMbnInterface