共用方式為

WifiConfig_StoreOpenNetwork函數

  • 發行項

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

重要

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

儲存未使用金鑰的開放 Wi-Fi 網路。 此函數並不安全對話。

如果裝置上已經儲存沒有金鑰的相同網路，此函數將會失敗。 請參閱 EEXIST) (錯誤一節。 不過，如果儲存的網路包含金鑰以及相同的 SSID，則此函數將會成功並儲存網路。

int WifiConfig_StoreOpenNetwork(const uint8_t * ssid, size_t ssidLength);

參數

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

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

錯誤

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

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

  • EEXIST：已儲存 Wi-Fi 具有相同 SSID 且沒有金鑰的網路。

  • EFAULT：IS ssid Null。

  • ERANGE：這是 ssidLength 0 或大於 WIFICONFIG_SSID_MAX_LENGTH。

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

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

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

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

傳回值

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

應用程式資訊清單需求

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