Класс QNetworkConfiguration

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

Этот класс устарел. Он предоставляется для поддержки работы старого исходного кода. Мы настоятельно рекомендуем не использовать его в новом коде.

Этот класс был представлен в Qt 4.7.

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

Типы public

Функции public

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

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

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

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

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

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

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

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

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

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

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

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

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

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

enum QNetworkConfiguration::Purpose

Определяет назначение конфигурации.

enum QNetworkConfiguration::StateFlagflags QNetworkConfiguration::StateFlags

Определяет состояния конфигурации.

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

enum QNetworkConfiguration::Type

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

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

QNetworkConfiguration::QNetworkConfiguration(const QNetworkConfiguration &other)

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

QNetworkConfiguration::QNetworkConfiguration()

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

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

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

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

QNetworkConfiguration::~QNetworkConfiguration()

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

QNetworkConfiguration::BearerType QNetworkConfiguration::bearerType() const

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

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

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

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

QNetworkConfiguration::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 могут иметь дочерние элементы. В противном случае эта функция возвращает пустой список.

int QNetworkConfiguration::connectTimeout() const

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

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

См. также setConnectTimeout.

QString QNetworkConfiguration::identifier() const

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

bool QNetworkConfiguration::isRoamingAvailable() const

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

bool QNetworkConfiguration::isValid() const

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

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

См. также QNetworkConfigurationManager.

QString QNetworkConfiguration::name() const

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

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

QNetworkConfiguration::Purpose QNetworkConfiguration::purpose() const

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

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

bool QNetworkConfiguration::setConnectTimeout(int timeout)

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

Примечание: timeout в миллисекундах.

Предупреждение: Это не повлияет, если плагин носителя не имеет возможности CanStartAndStopInterfaces.

Возвращает true, если удалось.

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

См. также connectTimeout.

QNetworkConfiguration::StateFlags QNetworkConfiguration::state() const

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

void QNetworkConfiguration::swap(QNetworkConfiguration &other)

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

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

QNetworkConfiguration::Type QNetworkConfiguration::type() const

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

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

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

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

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

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