Dela via

funktionen WifiConfig_SetConfigName

  • Artikel

Sidhuvud: #include <applibs/wificonfig.h>

Anger ett namn för en nätverkskonfiguration. Namnet kan användas som ett praktiskt handtag för att identifiera en nätverkskonfiguration. Vi rekommenderar starkt att det här namnet är unikt.

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

Parametrar

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

  • configname En pekare till en bytematris som innehåller konfigurationsnamnet. Bytematrisen måste vara NULL-avslutad och vara mindre än eller lika med WIFICONFIG_CONFIG_NAME_MAX_LENGTH byte (exklusive 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_CONFIG_NAME_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.