WifiConfig_GetScannedNetworks-Funktion

Header: #include <applibs/wificonfig.h>

Ruft die Wi-Fi Netzwerke ab, die beim letzten Scanvorgang gefunden wurden. Diese Funktion ist nicht threadsicher.

• Wenn scannedNetworkArray zu klein ist, um alle Netzwerke aufzunehmen, füllt diese Funktion alle Elemente aus und gibt die Anzahl der Arrayelemente zurück.

• Wenn die WiFiConfig-Funktion nicht vorhanden ist, gibt die Funktion ein leeres Array zurück.

ssize_t WifiConfig_GetScannedNetworks(WifiConfig_ScannedNetwork * scannedNetworkArray, size_t scannedNetworkArrayCount);

Parameter

• scannedNetworkArray Ein Zeiger auf ein Array, das die abgerufene Wi-Fi Netzwerke zurückgibt.

• scannedNetworkArrayCount Die Anzahl der Elemente, die gescanntNetworkArray enthalten kann. Das Array sollte über ein Element für jedes Wi-Fi Netzwerk verfügen, das beim letzten Scanvorgang gefunden wurde.

Fehler

Gibt -1 zurück, wenn ein Fehler auftritt, und legt auf den Fehlerwert fest errno .

• EACCES: Das Anwendungsmanifest enthält die WifiConfig-Funktion nicht.

• EFAULT: Der scannedNetworkArray Parameter ist NULL.

• ERANGE: Der scannedNetworkArrayCount Parameter ist 0.

• EINVAL: Der scannedNetworkArray Parameter oder seine Strukturversion ist ungültig.

• EAGAIN: Das Wi-Fi Gerät ist noch nicht bereit.

Auch andere errno Fehler können angegeben werden. Solche Fehler sind nicht deterministisch, und dasselbe Verhalten wird möglicherweise nicht durch Systemupdates beibehalten.

Rückgabewert

Gibt die Anzahl von WifiConfig_ScannedNetwork Elementen zurück, die von scandNetworkArray zurückgegeben werden, oder -1 für Fehler. In diesem Fall errno wird auf den Fehlerwert festgelegt.

Anforderungen an das Anwendungsmanifest

Das Anwendungsmanifest muss die WifiConfig-Funktion enthalten.