Dela via

funktionen WifiConfig_AddDuplicateNetwork

  • Artikel

Sidhuvud: #include <applibs/wificonfig.h>

Lägger till ett nytt nätverk som är en dubblett av det angivna nätverket med angivet ID. Det nya nätverket tilldelas det angivna namnet och är inaktiverat som standard.

int WifiConfig_AddDuplicateNetwork(int networkId, const char *configName);

Parametrar

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

  • configName En pekare till en bytematris som innehåller konfigurationsnamnet. Matrisen måste vara NULL-avslutad och högst WIFICONFIG_CONFIG_NAME_MAX_LENGTH byte, exklusive avslutningstecknet.

Fel

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

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

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

  • EEXIST: är configName inte unik.

  • EFAULT: är configName NULL.

  • EINVAL: är networkId ogiltigt.

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

  • ENODEV: matchar networkId inte något av de lagrade nätverken.

  • ENOMEM: Det finns inte tillräckligt med minne för att lägga till ett nytt nätverk.

  • ERANGE: har configName färre än ett tecken eller fler än WIFICONFIG_CONFIG_NAME_MAX_LENGTH tecken.

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

Returvärde

Returnerar ID för det nya nätverket, eller -1 för fel, i vilket fall errno är inställt på felvärdet. Nätverks-ID är noll eller ett positivt värde.

Anmärkningar

Det nya nätverket är inte konfigurerat och kan konfigureras med funktionerna WifiConfig_Set* . Ändringar av nätverkskonfigurationen börjar gälla omedelbart men går förlorade när enheten startas om om inte funktionen WifiConfig_PersistConfig anropas för att spara konfigurationen till icke-volatil lagring.

Antalet nätverk som du kan lagra på en enhet är inte fast, men beror på tillgängliga resurser och hur mycket lagringsutrymme som krävs för varje nätverkskonfiguration.

Krav för programmanifest

Programmanifestet måste innehålla WifiConfig-funktionen.