共用方式為

WifiConfig_StoreWpa2Network函數

  • 發行項

頁首： #include < applibs/wificonfig.h>

重要

此函數已過時。 請改用 WifiConfig_AddNetwork 。

儲存使用預先共用金鑰的 WPA2 Wi-Fi 網路。 此函數並不安全對話。

注意

如果已儲存具有相同 SSID 和預先共用金鑰的網路，此函數將會失敗。 請參閱 EEXIST) (錯誤一節。

int WifiConfig_StoreWpa2Network(const uint8_t * ssid, size_t ssidLength, const char * psk, size_t pskLength);

參數

  • ssid 指向 SSID 位元組陣列的指標，其中含有識別 Wi-Fi 網路的未指定字元編碼。

  • ssidLength Wi-Fi 網路 SSID 中的位元組數。

  • psk 包含 Wi-Fi 網路預先共用金鑰的緩衝區指標。

  • pskLength Wi-Fi 網路預先共用金鑰的長度。

錯誤

如果發生錯誤並設定為 errno 錯誤值，則傳回 -1。

  • EACCES：應用程式資訊清單不包含 WifiConfig 功能。

  • EEXIST：已儲存 Wi-Fi 網路已存在且具有相同 SSID 且使用 WPA2 的網路。

  • EFAULT：或 ssidpsk 為 Null。

  • ERANGE：或 ssidLengthpskLength 參數為 0 或大於 WIFICONFIG_SSID_MAX_LENGTH 和 WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE 。

  • EAGAIN：Wi-Fi 裝置尚未準備就緒。

  • ENETDOWN：無法使用 Wi-Fi 網路介面。

  • ENOSPC：有太多 Wi-Fi 網路無法持續進行設定;移除其中一個，然後再試一次。

您也可以指定任何其他 errno 錯誤;這類錯誤不是不確定的，同樣的行為可能無法透過系統更新來保留。

傳回值

會傳回 0 表示成功，而失敗則傳回 -1，在這種情況下 errno 會設定為錯誤值。

應用程式資訊清單需求

應用程式 資訊清單 必須包含 WifiConfig 功能。