WifiConfig_GetNetworkIdByConfigName函數

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

取得具有指定名稱之網路設定的網路識別碼。 使用 WifiConfig_SetConfigName 指派網路名稱。 網路識別碼可能會隨著網路設定的新增和移除而變更，因此應用程式應該在變更儲存的網路設定之前，再次取得網路識別碼。

int WifiConfig_GetNetworkIdByConfigName(const char *configName);

參數

• configName 指向網路設定名稱的指標。 此名稱是使用 WifiConfig_SetConfigName設定的。 字串必須是 Null 終止，且小於或等於 WIFICONFIG_CONFIG_NAME_MAX_LENGTH 位元組 (排除終止) 。

錯誤

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

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

• EFAULT：參數 configName 為 Null。

• ERANGE：參數 configName 大於 WIFICONFIG_SSID_MAX_LENGTH 。

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

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

• ENODEV：找不到指定的網路設定。

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

傳回值

傳回指定網路的網路識別碼 (非負值) ，或是 -1 為失敗，在這種情況下 errno 會設定為錯誤值。 網路識別碼會傳遞給WifiConfig_Setxxx函數，做為要設定網路的識別碼。

應用程式資訊清單需求

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