共用方式為

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 網路新增至裝置，並傳回網路識別碼。
WifiConfig_AddDuplicateNetwork 新增一個與現有網路重複的網路。
WifiConfig_ForgetAllNetworks 從裝置移除所有儲存 Wi-Fi 網路。 中斷裝置與任何已連線網路的連線。
WifiConfig_ForgetNetwork 過時： 此函數已過時。 請改用 WifiConfig_ForgetNetworkById 。
WifiConfig_ForgetNetworkById 從裝置移除 Wi-Fi 網路。
WiFiConfig_GetClientCertStoreIdentifier 取得網路所儲存用戶端憑證的識別碼。
WiFiConfig_GetClientIdentity 取得網路的用戶端身分識別。
WifiConfig_GetConnectedNetworkId 取得目前連線網路的識別碼。
WifiConfig_GetCurrentNetwork 取得已連線到裝置的 Wi-Fi 網路。
WifiConfig_GetNetworkDiagnostics 取得有關最近網路失敗的資訊。
WifiConfig_GetNetworkIdByConfigName 取得具有指定名稱之網路設定的網路識別碼。
WiFiConfig_GetRootCACertStoreIdentifier 取得網路所儲存之 Root 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 列舉 的安全性設定數值型別。