Dela via

funktionen WifiConfig_SetSSID

  • Artikel

Sidhuvud: #include <applibs/wificonfig.h>

Anger SSID för ett Wi-Fi nätverk.

Inställningen börjar gälla omedelbart men finns inte kvar på alla enhetsstarter om inte funktionen WifiConfig_PersistConfig anropas efter den här funktionen.

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

Parametrar

  • networkId ID för nätverket som ska konfigureras. WifiConfig_AddNetwork returnerar nätverks-ID: et.

  • ssid En pekare till en bytematris som innehåller det nya SSID:t. Teckenkodningen anges inte.

  • ssidLength Antalet byte i parametern ssid . Måste vara mindre än eller lika med WIFICONFIG_SSID_MAX_LENGTH.

Fel

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

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

  • EFAULT: parametern ssid är NULL.

  • ERANGE: parametern ssidLength ä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.

  • EINVAL: parametern networkId är ogiltig.

  • ENODEV: parametern networkId matchar inte något av ID:na för de lagrade nätverken.

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

Returvärde

Returnerar 0 för lyckat resultat, eller -1 för fel, i vilket fall errno är inställt på felvärdet.

Krav för programmanifest

Programmanifestet måste innehålla WifiConfig-funktionen.