WifiConfig_SetConfigName functie

Header: #include <applibs/wificonfig.h>

Hiermee stelt u een naam in voor een netwerkconfiguratie. De naam kan worden gebruikt als een handige ingang om een netwerkconfiguratie te identificeren. Het wordt sterk aanbevolen om deze naam uniek te maken.

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_SetConfigName(int networkId, const char *configName);

Parameters

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

• configname Een aanwijzer naar een bytematrix met de configuratienaam. De bytematrix moet NULL beëindigd zijn en kleiner dan of gelijk zijn aan WIFICONFIG_CONFIG_NAME_MAX_LENGTH bytes (met uitzondering van de beëindiging).

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 configName parameter is NULL.

• ERANGE: de configName parameter is groter dan WIFICONFIG_CONFIG_NAME_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.