WifiConfig_AddDuplicateNetwork functie

Header: #include <applibs/wificonfig.h>

Hiermee voegt u een nieuw netwerk toe dat een duplicaat is van het opgegeven netwerk met de opgegeven id. Het nieuwe netwerk krijgt de opgegeven naam toegewezen en is standaard uitgeschakeld.

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

Parameters

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

• configName Een aanwijzer naar een bytematrix die de configuratienaam bevat. De matrix moet NULL beëindigd en maximaal WIFICONFIG_CONFIG_NAME_MAX_LENGTH bytes zijn, met uitzondering van het beëindigingsteken.

Fouten

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

• EACCES: het toepassingsmanifest bevat niet de mogelijkheid WifiConfig.

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

• EEXIST: de configName is niet uniek.

• EFAULT: de configName is NULL.

• EINVAL: de networkId is ongeldig.

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

• ENODEV: de networkId komt niet overeen met een van de opgeslagen netwerken.

• ENOMEM: er is onvoldoende geheugen om een nieuw netwerk toe te voegen.

• ERANGE: de configName heeft minder dan één teken of meer dan WIFICONFIG_CONFIG_NAME_MAX_LENGTH tekens.

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

Retourwaarde

Retourneert de id van het nieuwe netwerk, of -1 voor een fout, in welk geval errno is ingesteld op de foutwaarde. De netwerk-id is nul of een positieve waarde.

Opmerkingen

Het nieuwe netwerk is niet geconfigureerd en kan worden geconfigureerd met de functies WifiConfig_Set* . Wijzigingen in de netwerkconfiguratie zijn onmiddellijk van kracht, maar gaan verloren wanneer het apparaat opnieuw wordt opgestart, tenzij de functie WifiConfig_PersistConfig wordt aangeroepen om de configuratie op te slaan in niet-compatibele opslag.

Het aantal netwerken dat u op een apparaat kunt opslaan, is niet vast, maar is afhankelijk van de beschikbare resources en de hoeveelheid opslagruimte die nodig is voor elke netwerkconfiguratie.

Vereisten voor toepassingsmanifest

Het toepassingsmanifest moet de mogelijkheid WifiConfig bevatten.