Condividi tramite

Funzione WifiConfig_GetNetworkIdByConfigName

  • Articolo

Intestazione: #include <applibs/wificonfig.h>

Ottiene l'ID di rete per la configurazione di rete con il nome specificato. Usare WifiConfig_SetConfigName per assegnare il nome della rete. L'ID di rete può cambiare quando vengono aggiunte e rimosse configurazioni di rete, quindi le app devono recuperare l'ID di rete prima di modificare una configurazione di rete archiviata.

int WifiConfig_GetNetworkIdByConfigName(const char *configName);

Parametri

  • configName Puntatore al nome della configurazione di rete. Questo nome è stato impostato usando WifiConfig_SetConfigName. La stringa deve essere terminata con valore NULL ed essere minore o uguale a WIFICONFIG_CONFIG_NAME_MAX_LENGTH byte (esclusa la terminazione).

Errori

Restituisce -1 se si verifica un errore e imposta errno il valore di errore.

  • EACCES: il manifesto dell'applicazione non include la funzionalità WifiConfig.

  • EFAULT: il configName parametro è NULL.

  • ERANGE: il configName parametro è maggiore di WIFICONFIG_SSID_MAX_LENGTH.

  • EAGAIN: il dispositivo Wi-Fi non è pronto.

  • ENETDOWN: l'interfaccia di rete Wi-Fi non è disponibile.

  • ENODEV: impossibile trovare la configurazione di rete specificata.

Potrebbero anche essere specificati altri errno errori. Tali errori non sono deterministici e lo stesso comportamento potrebbe non essere mantenuto tramite gli aggiornamenti di sistema.

Valore restituito

Restituisce l'ID di rete della rete specificata (valore non negativo) o -1 per errore, nel qual caso errno è impostato sul valore di errore. L'ID di rete viene passato alle funzioni WifiConfig_Setxxx come identificatore della rete da configurare.

Requisiti del manifesto dell'applicazione

Il manifesto dell'applicazione deve includere la funzionalità WifiConfig.