共用方式為

WifiConfig_SetPSK函數

  • 發行項

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

設定 Wi-Fi 網路的 PSK) 預先共用金鑰 (。 PSK 用於設定安全性類型的網路 WifiConfig_Security_Wpa2_Psk 。

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

static int WifiConfig_SetPSK(int networkId, const char *psk, size_t pskLength);

參數

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

  • psk 指向包含網路 PSK 之緩衝區的指標。

  • pskLength 網路 PSK 的長度。 此參數必須小於或等於 WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE 。

錯誤

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

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

  • EFAULT：參數 psk 為 Null。

  • ERANGE：參數 pskLength 大於 WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE 。

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

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

  • EINVAL：參數 networkId 無效。

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

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

傳回值

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

應用程式資訊清單需求

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