通过

Applibs wificonfig.h

  • 项目

标头： #include <applibs/wificonfig.h>

Applibs wificonfig 标头包含用于管理设备上的 Wi-Fi 网络配置的函数和类型。

注意

若要使用这些函数，请使用所使用的结构版本定义WIFICONFIG_STRUCTS_VERSION。 目前，唯一有效的版本是 1， (定义WIFICONFIG_STRUCTS_VERSION 1) 。 此后，可以使用以 WifiConfig_ 开头的WifiConfig_结构的友好名称。

应用程序清单要求

仅当应用程序在应用程序清单中具有 WifiConfig 功能时，才能调用这些函数。 如果应用程序管理 EAP-TLS 网络的任何设置，则还需要 EnterpriseWifiConfig 功能。

线程安全性

这些函数不是线程安全的。

概念和示例

功能

功能 描述
WifiConfig_AddNetwork 将 Wi-Fi 网络添加到设备，并返回网络的 ID。
WifiConfig_AddDuplicateNetwork 添加一个新网络，该网络是现有网络的副本。
WifiConfig_ForgetAllNetworks 从设备中删除所有存储 Wi-Fi 网络。 断开设备与任何连接的网络的连接。
WifiConfig_ForgetNetwork 过时： 此函数已过时。 请改用 WifiConfig_ForgetNetworkById 。
WifiConfig_ForgetNetworkById 从设备中删除 Wi-Fi 网络。
WiFiConfig_GetClientCertStoreIdentifier 获取网络存储的客户端证书的标识符。
WiFiConfig_GetClientIdentity 获取网络的客户端标识。
WifiConfig_GetConnectedNetworkId 获取当前连接的网络的 ID。
WifiConfig_GetCurrentNetwork 获取连接到设备的 Wi-Fi 网络。
WifiConfig_GetNetworkDiagnostics 获取有关最近网络故障的信息。
WifiConfig_GetNetworkIdByConfigName 获取具有给定名称的网络配置的网络 ID。
WiFiConfig_GetRootCACertStoreIdentifier 获取网络存储的根 CA 证书的标识符。
WifiConfig_GetScannedNetworks 获取上次扫描操作找到的 Wi-Fi 网络。
WifiConfig_GetStoredNetworkCount 获取设备上存储 Wi-Fi 网络的数量。
WifiConfig_GetStoredNetworks 检索设备上存储的所有 Wi-Fi 网络。
WifiConfig_PersistConfig 将当前网络配置写入非易失性存储，以便在设备重新启动后保持该配置。
WifiConfig_ReloadConfig 重新加载 Wi-Fi 配置。
WiFiConfig_SetClientCertStoreIdentifier 为网络设置存储的客户端证书的标识符。
WiFiConfig_SetClientIdentity 设置网络的客户端标识。
WifiConfig_SetConfigName 设置网络配置的名称。 该名称可用作标识网络配置的便捷句柄。
WifiConfig_SetNetworkEnabled 启用或禁用 Wi-Fi 网络配置。
WifiConfig_SetPSK 为 Wi-Fi 网络设置预共享密钥 (PSK) 。
WiFiConfig_SetRootCACertStoreIdentifier 为网络设置存储的根 CA 证书的标识符。
WifiConfig_SetSecurityType 设置 Wi-Fi 网络的安全类型。
WifiConfig_SetSsid 设置 Wi-Fi 网络的 SSID。
WifiConfig_SetTargetedScanEnabled 启用或禁用网络的目标扫描。
WifiConfig_StoreOpenNetwork 过时： 此函数已过时。 请改用 WifiConfig_AddNetwork 。
WifiConfig_StoreWpa2Network 过时： 此函数已过时。 请改用 WifiConfig_AddNetwork 。
WifiConfig_TriggerScanAndGetScannedNetworkCount 启动扫描以查找所有可用的 Wi-Fi 网络。

结构

结构 描述
WifiConfig_ClientIdentify 与网络关联的客户端标识。
WifiConfig_ConnectedNetwork 连接的 Wi-Fi 网络的属性，表示 802.11 基本服务集 (BSS) 。
WifiConfig_NetworkDiagnostics 有关最近连接到网络失败的信息。
WifiConfig_ScannedNetwork 已扫描 Wi-Fi 网络的属性，表示 802.11 BSS。
WifiConfig_StoredNetwork 存储 Wi-Fi 网络的属性，表示 802.11 BSS。

枚举

枚举 描述
WifiConfig_Security Wi-Fi 网络的安全密钥设置。

Typedefs

Typedef 描述
WifiConfig_Security_Type 指定 WifiConfig_Security 枚举的安全设置值的类型。