Класс QNetworkConfigurationManager

Класс QNetworkConfigurationManager управляет сетевыми конфигурациями, предоставляемыми системой. Подробнее...

• Список всех членов, включая унаследованные
• Устаревшие члены

Открытые типы

Открытые функции

• 31 открытая функция, унаследованная от QObject

Открытые слоты

• 1 открытый слот, унаследованный от QObject

Сигналы

• 2 сигнала, унаследованные от QObject

Статические открытые члены

• 9 статических открытых членов, унаследованных от QObject

Дополнительные унаследованные члены

• 1 свойство, унаследованное от QObject
• 9 защищенных функций, унаследованных от QObject

Подробное описание

Класс QNetworkConfigurationManager управляет сетевыми конфигурациями, предоставляемыми системой.

QNetworkConfigurationManager предоставляет доступ к сетевым конфигурациям, известным системе, и позволяет приложениям определять возможности системы (в отношении сетевых сессий) во время выполнения.

Класс QNetworkConfiguration абстрагирует набор параметров конфигурации, описывающих, как должен быть настроен сетевой интерфейс для подключения к определенной целевой сети. QNetworkConfigurationManager поддерживает и обновляет глобальный список QNetworkConfigurations. Приложения могут получать доступ и фильтровать этот список через всеКонфигурации(). Если добавляется новая конфигурация или удаляется или изменяется существующая, соответственно, будут отправлены сигналы конфигурацияДобавлена(), конфигурацияУдалена() и конфигурацияИзменена().

Метод поУмолчаниюКонфигурация() можно использовать при намерении немедленно создать новую сетевую сессию, не заботясь о конкретной конфигурации. Он возвращает конфигурацию QNetworkConfiguration::Discovered. Если не существует ни одной обнаруженной, возвращается недействительная конфигурация.

Некоторые обновления конфигурации могут потребовать некоторого времени для выполнения обновлений. Например, сканирование WLAN. Если платформа не выполняет внутренние обновления, может потребоваться вручную инициировать обновления конфигурации с помощью QNetworkConfigurationManager::обновитьКонфигурации(). О завершении процесса обновления сигнализируется отправкой сигнала обновлениеЗавершено(). Процесс обновления гарантирует, что каждый существующий экземпляр QNetworkConfiguration будет обновлен. Нет необходимости запрашивать обновленный список конфигураций через всеКонфигурации().

См. также QNetworkConfiguration.

Документация по типам членов

перечисление QNetworkConfigurationManager::Возможностьфлаги QNetworkConfigurationManager::Возможности

Указывает системные возможности API-интерфейса носителя. Возможные значения:

Тип Capabilities — это typedef для QFlags<Capability>. Он хранит логическое ИЛИ сочетание значений Capability.

Документация по членам-функциям

QNetworkConfigurationManager::QNetworkConfigurationManager(QObject *parent = nullptr)

Создаёт объект QNetworkConfigurationManager с заданным parent.

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

[virtual] QNetworkConfigurationManager::~QNetworkConfigurationManager()

Освобождает ресурсы, связанные с объектом QNetworkConfigurationManager.

QList<QNetworkConfiguration> QNetworkConfigurationManager::allConfigurations(QNetworkConfiguration::StateFlags filter = ...) const

Возвращает список конфигураций, соответствующих заданному filter.

По умолчанию эта функция возвращает все (определённые и неопределённые) конфигурации.

Беспроводная сеть с определённым SSID может быть доступна только в определённой области, несмотря на то, что система имеет для неё действительную конфигурацию. Поэтому флаг фильтра может использоваться для ограничения списка только обнаруженными и, возможно, подключёнными конфигурациями.

Если filter равен нулю, эта функция возвращает все возможные конфигурации.

Обратите внимание, что эта функция возвращает состояния всех конфигураций на момент вызова этой функции. Например, если определена конфигурация типа WLAN, системе может потребоваться выполнить сканирование WLAN, чтобы определить, действительно ли она доступна. Для получения наиболее точного состояния следует использовать updateConfigurations() для обновления состояния каждой конфигурации. Обратите внимание, что такое обновление может занять некоторое время. О его завершении сигнализирует updateCompleted(). При отсутствии обновления конфигурации эта функция возвращает наилучшую оценку на момент вызова. Поэтому, если вас интересуют конфигурации WLAN, рекомендуется вызвать updateConfigurations() один раз после создания экземпляра QNetworkConfigurationManager (сканирование WLAN занимает слишком много времени, чтобы его выполнять в конструкторе). После этого данные будут автоматически обновляться по мере сообщения системы об изменениях.

QNetworkConfigurationManager::Capabilities QNetworkConfigurationManager::capabilities() const

Возвращает возможности, поддерживаемые текущей платформой.

[signal] void QNetworkConfigurationManager::configurationAdded(const QNetworkConfiguration &config)

Этот сигнал излучается всякий раз, когда к системе добавляется новая сетевая конфигурация. Новая конфигурация задаётся параметром config.

[signal] void QNetworkConfigurationManager::configurationChanged(const QNetworkConfiguration &config)

Этот сигнал излучается, когда состояние config меняется.

QNetworkConfiguration QNetworkConfigurationManager::configurationFromIdentifier(const QString &identifier) const

Возвращает QNetworkConfiguration для identifier; в противном случае возвращает недействительную QNetworkConfiguration.

См. также QNetworkConfiguration::identifier().

[signal] void QNetworkConfigurationManager::configurationRemoved(const QNetworkConfiguration &config)

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

QNetworkConfiguration QNetworkConfigurationManager::defaultConfiguration() const

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

В некоторых случаях может потребоваться вызвать updateConfigurations() и дождаться сигнала updateCompleted() перед вызовом этой функции.

См. также allConfigurations().

bool QNetworkConfigurationManager::isOnline() const

Возвращает true , если система считается подключённой к другому устройству через активный сетевой интерфейс; в противном случае возвращает false.

Это эквивалентно следующему фрагменту кода:

QNetworkConfigurationManager mgr;
QList<QNetworkConfiguration> activeConfigs = mgr.allConfigurations(QNetworkConfiguration::Active);
if (activeConfigs.count() > 0)
    Q_ASSERT(mgr.isOnline());
else
    Q_ASSERT(!mgr.isOnline());

См. также onlineStateChanged().

[signal] void QNetworkConfigurationManager::onlineStateChanged(bool isOnline)

Этот сигнал излучается, когда устройство переходит из онлайн в офлайн режим или наоборот. isOnline представляет новое состояние устройства.

Состояние считается онлайн до тех пор, пока allConfigurations(QNetworkConfiguration::Active) возвращает список с хотя бы одной записью.

[signal] void QNetworkConfigurationManager::updateCompleted()

Этот сигнал излучается, когда обновление конфигурации завершено. Такое обновление может быть инициировано с помощью updateConfigurations().

[slot] void QNetworkConfigurationManager::updateConfigurations()

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

Этот вызов является асинхронным. По завершении этого обновления излучается сигнал updateCompleted(). Если обнаружены новые конфигурации или старые были удалены или изменены, процесс обновления может вызвать излучение одного или нескольких сигналов configurationAdded(), configurationRemoved() и configurationChanged().

Если состояние конфигурации меняется в результате этого обновления, все существующие экземпляры QNetworkConfiguration обновляются автоматически.

См. также allConfigurations().