Dela via

funktionen WifiConfig_GetNetworkIdByConfigName

  • Artikel

Sidhuvud: #include <applibs/wificonfig.h>

Hämtar nätverks-ID:t för nätverkskonfigurationen med det angivna namnet. Använd WifiConfig_SetConfigName för att tilldela nätverksnamnet. Nätverks-ID:t kan ändras när nätverkskonfigurationer läggs till och tas bort, så appar bör få nätverks-ID:t igen innan en lagrad nätverkskonfiguration ändras.

int WifiConfig_GetNetworkIdByConfigName(const char *configName);

Parametrar

  • configName En pekare till namnet på nätverkskonfigurationen. Det här namnet angavs med WifiConfig_SetConfigName. Strängen måste vara NULL-avslutad och vara mindre än eller lika med WIFICONFIG_CONFIG_NAME_MAX_LENGTH byte (förutom avslutningen).

Fel

Returnerar -1 om ett fel uppstår och anger errno felvärdet.

  • EACCES: programmanifestet innehåller inte WifiConfig-funktionen.

  • EFAULT: parametern configName är NULL.

  • ERANGE: parametern configName är större än WIFICONFIG_SSID_MAX_LENGTH.

  • EAGAIN: Wi-Fi-enheten är inte klar.

  • ENETDOWN: det Wi-Fi nätverksgränssnittet är inte tillgängligt.

  • ENODEV: det går inte att hitta den angivna nätverkskonfigurationen.

errno Andra kan också anges, sådana fel är inte deterministiska och samma beteende kanske inte behålls via systemuppdateringar.

Returvärde

Returnerar nätverks-ID:t för det angivna nätverket (icke-negativt värde) eller -1 för fel, i vilket fall errno felvärdet är inställt. Nätverks-ID:t skickas till de WifiConfig_Setxxx funktionerna som identifierare för nätverket som ska konfigureras.

Krav för programmanifest

Programmanifestet måste innehålla WifiConfig-funktionen.