Qt网络编程：QNetworkConfiguration

一、描述

QNetworkConfiguration 封装了单个接入点或服务网络。

单个接入点配置可以映射到一个网络接口。然而，单个网络接口可能并不总是只映射到一个接入点配置。同一网络设备的多种配置可以启用多个接入点。如智能手机允许用户管理多个 WLAN 配置，而设备本身只有一个 WLAN 网络设备。

QNetworkConfiguration 也支持服务网络的概念。这一概念允许将多个接入点配置分组为一个实体。这样的组称为服务网络，在需要到特定目标网络（例如公司网络）的网络会话的情况下可能是有益的。使用服务网络时，用户通常不关心选择了哪一种连接选项（例如，企业 WLAN 或通过 GPRS 的 VPN），只要他可以访问公司的目标服务器即可。此外，可以启用自动接入点漫游，使设备能够动态更改网络接口配置，同时保持应用程序与目标网络的连接。它允许适应不断变化的环境，并可以优化成本、速度或其他网络参数。

---

二、类型成员

1、enum QNetworkConfiguration::BearerType：指定配置使用的承载类型。

• BearerUnknown：承载类型未知或未指定。
• BearerEthernet：该配置用于以太网接口。
• BearerWLAN：该配置用于无线 LAN 接口。
• Bearer2G：该配置适用于 CSD、GPRS、HSCSD、EDGE 或 cdmaOne 接口。
• Bearer3G：配置为3G接口。
• Bearer4G：配置为4G接口。
• BearerCDMA2000：配置为CDMA接口。
• BearerWCDMA：该配置适用于 W-CDMA/UMTS 接口。
• BearerHSPA：该配置用于高速分组接入 (HSPA) 接口。
• BearerBluetooth：该配置用于蓝牙接口。
• BearerWiMAX：该配置适用于 WiMAX 接口。
• BearerEVDO：该配置用于 EVDO (3G) 接口。
• BearerLTE：该配置用于 LTE (4G) 接口。

2、enum QNetworkConfiguration::Purpose：指定配置的目的。

• UnknownPurpose：该配置没有指定任何目的。这是默认值。
• PublicPurpose：该配置可用于通用互联网访问。
• PrivatePurpose：该配置适用于访问办公室内网等私有网络。
• ServiceSpecificPurpose：该配置可用于运营商特定服务（例如接收彩信或内容流）。

3、enum QNetworkConfiguration::StateFlag：指定配置状态。

• Undefined：此状态用于临时配置，例如用户尚未实际为其创建配置的新发现的 WLAN。
• Defined：定义的配置对系统来说是已知的，但不能立即使用（例如，配置的 WLAN 不在范围内或以太网电缆当前未插入机器）。
• Discovered：发现的配置可以立即用于创建新的 QNetworkSession。 如果配置是服务网络，则如果至少一个底层接入点配置具有已发现状态，则设置此标志。
• Active：该配置当前由开放网络会话使用（QNetworkSession::isOpen()）。

4、enum QNetworkConfiguration::Type：此枚举描述配置的类型。

• InternetAccessPoint：该配置指定单个接入点的详细信息。
• ServiceNetwork：该配置基于一组 InternetAccessPoint 类型的 QNetworkConfiguration。 所有组成员都可以到达同一个目标网络。
• UserChoice：配置是一个占位符，当会话打开时，它将被平台解析为实际配置。根据平台，选择可能会生成一个弹出对话框，询问用户他的首选选择。
• Invalid：配置无效。

---

三、成员函数

1、QList<QNetworkConfiguration> children()

按优先级顺序返回此网络配置的所有子配置。列表中的第一个子配置具有最高优先级。

只有 ServiceNetwork 类型的网络配置可以有子级。

2、QString identifier()

返回此网络配置的唯一且特定于平台的标识符。

3、bool isRoamingAvailable()

配置是否支持漫游。

4、bool isValid()

此 QNetworkConfiguration 对象是否有效。如果用户删除配置或配置是默认构建的，则配置可能会失效。可以通过 QNetworkConfigurationManager 监控配置的添加和删除。

5、QString name()

返回此配置的用户可见名称。该名称可以是底层接入点的名称，也可以是此配置所代表的服务网络的名称。

6、bool setConnectTimeout(int timeout)

设置此配置的连接超时时间（毫秒）。