Delen via

WifiConfig_GetNetworkIdByConfigName functie

  • Artikel

Header: #include <applibs/wificonfig.h>

Hiermee haalt u de netwerk-id voor de netwerkconfiguratie op met de opgegeven naam. Gebruik WifiConfig_SetConfigName om de netwerknaam toe te wijzen. De netwerk-id kan veranderen wanneer netwerkconfiguraties worden toegevoegd en verwijderd, zodat apps de netwerk-id opnieuw moeten ophalen voordat een opgeslagen netwerkconfiguratie wordt gewijzigd.

int WifiConfig_GetNetworkIdByConfigName(const char *configName);

Parameters

  • configName Een verwijzing naar de naam van de netwerkconfiguratie. Deze naam is ingesteld met behulp van WifiConfig_SetConfigName. De tekenreeks moet NULL beëindigd zijn en kleiner zijn dan of gelijk 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_SSID_MAX_LENGTH.

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

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

  • ENODEV: de opgegeven netwerkconfiguratie kan niet worden gevonden.

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

Retourwaarde

Retourneert de netwerk-id van het opgegeven netwerk (niet-negatieve waarde) of -1 voor fout, in welk geval errno is ingesteld op de foutwaarde. De netwerk-id wordt doorgegeven aan de WifiConfig_Setxxx fungeert als de id voor het te configureren netwerk.

Vereisten voor toepassingsmanifest

Het toepassingsmanifest moet de mogelijkheid WifiConfig bevatten.