Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Важно!
Начиная с 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ки.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
| Код возврата | Описание |
|---|---|
|
Метод завершился успешно. visibleProviders содержит допустимые значения. В зависимости от возраста информации вызывающее приложение может решить выполнить новый вызов ScanNetwork. |
|
Сведения недоступны. Выполняется активное сканирование сети. Вызывающее приложение может получать уведомления о доступности возможностей устройства, зарегистрировав метод OnScanNetworkCompleteобъекта IMbnInterfaceEvents. |
|
Кэш видимого списка сетей мобильной широкополосной связи недопустим. Вызывающее приложение должно вызвать ScanNetwork для заполнения кэша. |
Комментарии
Этот метод возвращает список видимых в настоящее время поставщиков. Устройства CDMA будут сообщать только о своем домашнем поставщике, если доступна какая-либо сеть из предпочтительного списка роуминга (PRL).
Чтобы избежать частых операций сканирования сети, операционная система поддерживает список последних операций сканирования, а список поставщиков возвращается из кэшированного списка.
Приложение может вызвать этот метод, чтобы получить список видимых поставщиков после завершения ScanNetwork.
Требования
| Минимальная версия клиента | Windows 7 [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Целевая платформа | Windows |
| Header | mbnapi.h |