Funzione WifiConfig_GetNetworkIdByConfigNameWifiConfig_GetNetworkIdByConfigName Function

Intestazione: #include <applibs/wificonfig.h>Header: #include <applibs/wificonfig.h>

Ottiene l'ID di rete per la configurazione di rete con il nome specificato.Gets the network ID for the network configuration with the given name. Usare WifiConfig_SetConfigName per assegnare il nome di rete.Use WifiConfig_SetConfigName to assign the network name. L'ID di rete potrebbe cambiare man mano che vengono aggiunte e rimosse le configurazioni di rete, di conseguenza è necessario che le app ottengano nuovamente l'ID di rete prima di modificare una configurazione di rete archiviata.The network ID may change as network configurations are added and removed, so apps should get the network ID again before changing a stored network configuration.

int WifiConfig_GetNetworkIdByConfigName(const char *configName);

ParametriParameters

  • configName: puntatore al nome della configurazione di rete.configName A pointer to the name of the network configuration. Questo nome è stato impostato tramite la funzione WifiConfig_SetConfigName.This name was set using WifiConfig_SetConfigName. La stringa deve avere una terminazione NULL ed essere minore o uguale a WIFICONFIG_CONFIG_NAME_MAX_LENGTH byte (esclusa la terminazione).The string must be NULL terminated and be less than or equal to WIFICONFIG_CONFIG_NAME_MAX_LENGTH bytes (excluding the termination).

ErrorsErrors

Restituisce-1 se viene rilevato un errore e imposta sul errno valore di errore.Returns -1 if an error is encountered and sets errno to the error value.

  • EACCES: il manifesto dell'applicazione non include la funzionalità WifiConfig.EACCES: the application manifest doesn't include the WifiConfig capability.

  • EFAULT: il parametro configName è NULL.EFAULT: the configName parameter is NULL.

  • ERANGE: la lunghezza del parametro configName è maggiore di WIFICONFIG_SSID_MAX_LENGTH.ERANGE: the configName parameter is greater than WIFICONFIG_SSID_MAX_LENGTH.

  • EAGAIN: il dispositivo Wi-Fi non è pronto.EAGAIN: the Wi-Fi device isn't ready.

  • ENETDOWN: l'interfaccia di rete Wi-Fi non è disponibile.ENETDOWN: the Wi-Fi network interface is unavailable.

  • ENODEV: la configurazione di rete specificata non è stata trovata.ENODEV: the specified network configuration cannot be found.

errnoÈ possibile specificare anche qualsiasi altro tipo di errore. tali errori non sono deterministici e lo stesso comportamento potrebbe non essere mantenuto tramite gli aggiornamenti del sistema.Any other errno may also be specified; such errors aren't deterministic and the same behavior might not be retained through system updates.

Valore restituitoReturn value

Restituisce l'ID di rete della rete specificata (valore non negativo) oppure-1 per l'errore, nel qual caso errno viene impostato sul valore di errore.Returns the network ID of the specified network (non-negative value), or -1 for failure, in which case errno is set to the error value. L'ID di rete viene passato alle funzioni WifiConfig_Setxxx come identificatore per la rete da configurare.The network ID is passed to the WifiConfig_Setxxx functions as the identifier for the network to be configured.

Requisiti del manifesto dell'applicazioneApplication manifest requirements

Il manifesto dell'applicazione deve includere la funzionalità WifiConfig.The application manifest must include the WifiConfig capability.