共用方式為

WifiConfig_SetConfigName函數

  • 發行項

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

設定網路設定的名稱。 您可以使用名稱做為識別網路設定的方便控點。 強烈建議您將此名稱設為唯一名稱。

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

static int WifiConfig_SetConfigName(int networkId, const char *configName);

參數

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

  • configname 指向包含組態名稱之位元組陣列的指標。 除終止) 外，位元組陣列必須由 Null 終止，並且小於或等於 WIFICONFIG_CONFIG_NAME_MAX_LENGTH 位元組 (。

錯誤

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

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

  • EFAULT：參數 configName 為 Null。

  • ERANGE：參數 configName 大於 WIFICONFIG_CONFIG_NAME_MAX_LENGTH 。

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

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

  • EINVAL：參數 networkId 無效。

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

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

傳回值

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

應用程式資訊清單需求

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