WifiConfig_SetSSID functie

Header: #include <applibs/wificonfig.h>

Hiermee stelt u de SSID voor een Wi-Fi-netwerk in.

De instelling is onmiddellijk van kracht, maar blijft niet behouden wanneer het apparaat opnieuw wordt opgestart, tenzij de functie WifiConfig_PersistConfig wordt aangeroepen na deze functie.

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

Parameters

• networkId De id van het netwerk dat moet worden geconfigureerd. WifiConfig_AddNetwork retourneert de netwerk-id.

• ssid Een aanwijzer naar een bytematrix die de nieuwe SSID bevat. De tekencodering is niet opgegeven.

• ssidLength Het aantal bytes in de ssid parameter. Moet kleiner dan of gelijk zijn aan WIFICONFIG_SSID_MAX_LENGTH.

Fouten

Retourneert -1 als er een fout optreedt en wordt ingesteld errno op de foutwaarde.

• EACCES: het toepassingsmanifest bevat niet de mogelijkheid WifiConfig.

• EFAULT: de ssid parameter is NULL.

• ERANGE: de ssidLength parameter is groter dan WIFICONFIG_SSID_MAX_LENGTH.

• EAGAIN: het Wi-Fi apparaat is niet gereed.

• ENETDOWN: de Wi-Fi netwerkinterface is niet beschikbaar.

• EINVAL: de networkId parameter is ongeldig.

• ENODEV: de networkId parameter komt niet overeen met een van de id's van de opgeslagen netwerken.

errno Andere fouten kunnen ook worden opgegeven; dergelijke fouten zijn niet deterministisch en hetzelfde gedrag wordt mogelijk niet bewaard via systeemupdates.

Retourwaarde

Retourneert 0 voor geslaagd, of -1 voor fout, in welk geval errno is ingesteld op de foutwaarde.

Vereisten voor toepassingsmanifest

Het toepassingsmanifest moet de mogelijkheid WifiConfig bevatten.