Класс QNetworkConfiguration

Класс QNetworkConfiguration предоставляет абстракцию одной или нескольких конфигураций точки доступа. Подробнее...

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

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

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

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

Класс QNetworkConfiguration предоставляет абстракцию одной или нескольких конфигураций точки доступа.

QNetworkConfiguration инкапсулирует одну точку доступа или сетевую службу. В большинстве случаев одна конфигурация точки доступа может быть сопоставлена одному сетевому интерфейсу. Однако один сетевой интерфейс не всегда может быть сопоставлен только с одной конфигурацией точки доступа. Несколько конфигураций для одного сетевого устройства могут активировать несколько точек доступа. Примером устройства, которое может иметь такую конфигурацию, может быть смартфон, который позволяет пользователю управлять несколькими конфигурациями WLAN, в то время как само устройство имеет только одно WLAN-сетевое устройство.

Класс QNetworkConfiguration также поддерживает концепцию сетевых служб. Эта концепция позволяет группировать несколько конфигураций точек доступа в одну сущность. Такая группа называется сетевой службой и может быть полезна в тех случаях, когда требуется сетевая сессия к определённой целевой сети (например, корпоративная сеть). При использовании сетевой службы пользователю обычно неважно, какой из вариантов подключения используется (например, корпоративная WLAN или VPN через GPRS), пока он может получить доступ к целевому серверу компании. В зависимости от текущего местоположения и времени некоторые точки доступа, которые составляют сетевую службу, могут быть недоступны. Кроме того, можно включить автоматическое переключение точек доступа, что позволяет устройству динамически изменять конфигурацию сетевого интерфейса, сохраняя при этом подключение приложения к целевой сети. Это позволяет адаптироваться к меняющейся среде и может оптимизировать затраты, скорость или другие параметры сети.

Специальные конфигурации типа ВыборПользователя обеспечивают конфигурацию-заполнитель, которая разрешается платформой до фактической конфигурации сети при открытии сессии. Не все платформы поддерживают концепцию конфигурации выбора пользователя.

Состояния конфигурации

Список доступных конфигураций можно получить с помощью QNetworkConfigurationManager::allConfigurations(). Конфигурация может иметь несколько состояний. Состояние конфигурации Определённое указывает, что конфигурация сохранена на устройстве. Однако конфигурация ещё не готова к активации, например, WLAN может быть недоступна в данный момент.

Состояние Обнаружено подразумевает, что конфигурация Определённая и внешние условия таковы, что конфигурацию можно использовать для немедленного открытия новой сетевой сессии. Примером таких внешних условий может быть подключение Ethernet-кабеля к устройству или наличие WLAN с указанным SSID в пределах досягаемости.

Состояние Активное подразумевает, что конфигурация Обнаружена. Конфигурация в этом состоянии в настоящее время используется приложением. Подлежащий сетевой интерфейс имеет действительную IP-конфигурацию и может передавать IP-пакеты между устройством и целевой сетью.

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

В зависимости от типа конфигурации некоторые состояния являются переходными по своей природе. Подключение GPRS/UMTS почти всегда может быть Обнаружено, если сеть GSM/UMTS доступна. Однако, если сеть GSM/UMTS теряет соединение, связанная конфигурация может изменить своё состояние с Обнаружено на Определённое. Аналогичный случай может быть вызван доступностью WLAN. QNetworkConfigurationManager::updateConfigurations() можно использовать для ручного запуска обновлений состояний. Обратите внимание, что на некоторых платформах такие обновления не требуются, поскольку они неявно изменяют состояние после его обнаружения. Если состояние конфигурации изменяется, все связанные экземпляры QNetworkConfiguration автоматически изменяют своё состояние.

См. также QNetworkSession и QNetworkConfigurationManager.

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

перечисление QNetworkConfiguration::ТипНосителя

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

enum QNetworkConfiguration::Purpose

Указывает назначение конфигурации.

enum QNetworkConfiguration::StateFlagflags QNetworkConfiguration::StateFlags

Указывает состояния конфигурации.

Тип StateFlags является typedef для QFlags<StateFlag>. Он хранит логическое ИЛИ комбинацию значений StateFlag.

enum QNetworkConfiguration::Type

Этот перечисление описывает тип конфигурации.

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

QNetworkConfiguration::QNetworkConfiguration()

Создаёт объект недействительной конфигурации.

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

QNetworkConfiguration::QNetworkConfiguration(const QNetworkConfiguration &other)

Создаёт копию объекта QNetworkConfiguration, содержащегося в other.

QNetworkConfiguration::~QNetworkConfiguration()

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

BearerType QNetworkConfiguration::bearerType() const

Возвращает тип носителя, используемый этой сетевой конфигурацией.

Если тип носителя неизвестен, функция bearerTypeName() может быть использована для получения текстового имени типа носителя.

Недействительная сетевая конфигурация всегда возвращает значение BearerUnknown.

См. также bearerTypeName() и bearerTypeFamily().

BearerType QNetworkConfiguration::bearerTypeFamily() const

Возвращает семейство типов носителей, используемое этой сетевой конфигурацией. Следующая таблица показывает, как значения bearerType() сопоставляются со значениями bearerTypeFamily():

Недействительная сетевая конфигурация всегда возвращает значение BearerUnknown.

Эта функция была добавлена в Qt 5.2.

См. также bearerType() и bearerTypeName().

QString QNetworkConfiguration::bearerTypeName() const

Возвращает тип несущей, используемой этой сетевой конфигурацией, в виде строки.

Строка не переводится и поэтому не может быть показана пользователю. В следующей таблице показаны фиксированные соответствия между BearerType и именем типа несущей для известных типов. Если BearerType неизвестен, эта функция может вернуть дополнительную информацию, если она доступна; в противном случае возвращается пустая строка.

Эта функция возвращает пустую строку, если это недействительная конфигурация, сетевая конфигурация типа QNetworkConfiguration::ServiceNetwork или QNetworkConfiguration::UserChoice.

См. также bearerType() и bearerTypeFamily().

QList<QNetworkConfiguration> QNetworkConfiguration::children() const

Возвращает все подконфигурации этой сетевой конфигурации в порядке приоритета. Первая подконфигурация в списке имеет наивысший приоритет.

Только сетевые конфигурации типа ServiceNetwork могут иметь подконфигурации. В противном случае эта функция возвращает пустой список.

QString QNetworkConfiguration::identifier() const

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

bool QNetworkConfiguration::isRoamingAvailable() const

Возвращает true если эта конфигурация поддерживает роуминг; в противном случае false.

bool QNetworkConfiguration::isValid() const

Возвращает true если этот объект QNetworkConfiguration является валидным. Конфигурация может стать невалидной, если пользователь удаляет конфигурацию или конфигурация была создана по умолчанию.

Добавление и удаление конфигураций может отслеживаться с помощью QNetworkConfigurationManager.

См. также QNetworkConfigurationManager.

QString QNetworkConfiguration::name() const

Возвращает видимое для пользователя имя этой конфигурации.

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

Purpose QNetworkConfiguration::purpose() const

Возвращает назначение этой конфигурации.

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

StateFlags QNetworkConfiguration::state() const

Возвращает текущее состояние конфигурации.

void QNetworkConfiguration::swap(QNetworkConfiguration &other)

Меняет местами эту сетевую конфигурацию с other. Эта функция очень быстрая и никогда не терпит неудач.

Эта функция была добавлена в Qt 5.0.

Type QNetworkConfiguration::type() const

Возвращает тип конфигурации.

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

bool QNetworkConfiguration::operator!=(const QNetworkConfiguration &other) const

Возвращает true если эта конфигурация не совпадает с предоставленной конфигурацией other; в противном случае возвращает false.

QNetworkConfiguration &QNetworkConfiguration::operator=(QNetworkConfiguration &&other)

Оператор перемещения присваивания.

QNetworkConfiguration &QNetworkConfiguration::operator=(const QNetworkConfiguration &other)

Копирует содержимое объекта QNetworkConfiguration, содержащегося в other, в этот.

bool QNetworkConfiguration::operator==(const QNetworkConfiguration &other) const

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