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

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

  • Статья

Важно!

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

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

Синтаксис

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

Параметры

[out] age

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

[out, retval] visibleProviders

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

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

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

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

Комментарии

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

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

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

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

Требования

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

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

IMbnMultiCarrier