WifiConfig_SetSSID函數

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

設定 Wi-Fi 網路的 SSID。

此設定會立即生效，但不會在裝置重新開機時持續執行，除非在此函數之後撥打 WifiConfig_PersistConfig 函數。

static int WifiConfig_SetSSID(int networkId, const uint8_t *ssid, size_t ssidLength);

參數

• networkId 要設定的網路識別碼。 WifiConfig_AddNetwork 傳回網路識別碼。

• ssid 指標指向包含新 SSID 的位元組陣列。 未指定字元編碼。

• ssidLength 這是參數中的 ssid 位元組數。 必須小於或等於 WIFICONFIG_SSID_MAX_LENGTH 。

錯誤

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

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

• EFAULT：參數 ssid 為 Null。

• ERANGE：參數 ssidLength 大於 WIFICONFIG_SSID_MAX_LENGTH 。

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

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

• EINVAL：參數 networkId 無效。

• ENODEV：參數 networkId 與 儲存網路的任何識別碼不相符。

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

傳回值

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

應用程式資訊清單需求

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