Funzione WifiConfig_GetScannedNetworksWifiConfig_GetScannedNetworks Function

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

Ottiene le reti Wi-Fi trovate dall'ultima operazione di analisi.Gets the Wi-Fi networks found by the last scan operation. Questa funzione non è thread-safe.This function is not thread safe.

  • Se il valore di scannedNetworkArray è troppo piccolo per contenere tutte le reti, questa funzione riempie tutti gli elementi e restituisce il numero di elementi della matrice.If scannedNetworkArray is too small to hold all the networks, this function fills all the elements and returns the number of array elements.

  • Se la funzionalità WiFiConfig non è presente, la funzione restituisce una matrice vuota.If the WiFiConfig capability is not present, the function returns an empty array.

ssize_t WifiConfig_GetScannedNetworks(WifiConfig_ScannedNetwork * scannedNetworkArray, size_t scannedNetworkArrayCount);

ParametriParameters

  • scannedNetworkArray Un puntatore a una matrice che restituisce le reti Wi-Fi recuperate.scannedNetworkArray A pointer to an array that returns the retrieved Wi-Fi networks.

  • scannedNetworkArrayCount Il numero di elementi che scannedNetworkArray può contenere.scannedNetworkArrayCount The number of elements scannedNetworkArray can hold. La matrice deve avere un elemento per ogni rete Wi-Fi trovata dall'ultima operazione di analisi.The array should have one element for each Wi-Fi network found by the last scan operation.

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 does not include the WifiConfig capability.

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

  • ERANGE: il parametro scannedNetworkArrayCount è 0.ERANGE: the scannedNetworkArrayCount parameter is 0.

  • EINVAL: il parametro scannedNetworkArray o la versione dello struct non è valida.EINVAL: the scannedNetworkArray parameter or its struct version is invalid.

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

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 il numero di elementi WifiConfig_ScannedNetwork restituiti da scannedNetworkArray oppure-1 per l'errore, nel qual caso errno viene impostato sul valore di errore.Returns the number of WifiConfig_ScannedNetwork elements returned by scannedNetworkArray, or -1 for failure, in which case errno is set to the error value.

Requisiti del manifesto dell'applicazioneApplication manifest requirements

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