Funzione WifiConfig_GetScannedNetworks

  • Articolo

Intestazione: #include <applibs/wificonfig.h>

Ottiene le reti Wi-Fi trovate dall'ultima operazione di analisi. Questa funzione non è thread-safe.

  • Se scannedNetworkArray è troppo piccola per contenere tutte le reti, questa funzione riempie tutti gli elementi e restituisce il numero di elementi di matrice.

  • Se la funzionalità WiFiConfig non è presente, la funzione restituisce una matrice vuota.

ssize_t WifiConfig_GetScannedNetworks(WifiConfig_ScannedNetwork * scannedNetworkArray, size_t scannedNetworkArrayCount);

Parametri

  • scannedNetworkArray Puntatore a una matrice che restituisce il Wi-Fi reti recuperate.

  • scannedNetworkArrayCount Il numero di elementi analizzatiNetworkArray può contenere. La matrice deve avere un elemento per ogni Wi-Fi rete individuata dall'ultima operazione di analisi.

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 scannedNetworkArray parametro è NULL.

  • ERANGE: il scannedNetworkArrayCount parametro è 0.

  • EINVAL: il scannedNetworkArray parametro o la versione struct non è valida.

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

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 il numero di elementi WifiConfig_ScannedNetwork restituiti da scannedNetworkArray o -1 per errore, nel qual caso errno viene impostato sul valore di errore.

Requisiti del manifesto dell'applicazione

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