Share via

WifiConfig_GetStoredNetworks-Funktion

  • Artikel

Header: #include <applibs/wificonfig.h>

Ruft alle gespeicherten Wi-Fi Netzwerke auf dem Gerät ab. Diese Funktion ist nicht threadsicher.

Hinweis

Bevor Sie WifiConfig_GetStoredNetworks aufrufen, müssen Sie WifiConfig_GetStoredNetworkCount aufrufen und das Ergebnis als Arraygröße für das WifiConfig_StoredNetwork Array verwenden, das als storedNetworkArray Parameter übergeben wird.

  • Wenn storedNetworkArray zu klein ist, um alle gespeicherten Wi-Fi-Netzwerke aufzunehmen, füllt diese Funktion das Array 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_GetStoredNetworks(WifiConfig_StoredNetwork * storedNetworkArray, size_t storedNetworkArrayCount);

Parameter

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

  • storedNetworkArrayCount Die Anzahl der Elemente storedNetworkArray , die enthalten sein können. Das Array sollte ein Element für jedes Wi-Fi Netzwerk enthalten.

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 storedNetworkArray Parameter ist NULL.

  • ERANGE: Der storedNetworkArrayCount Parameter ist 0.

  • EINVAL: Der storedNetworkArray 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 der Elemente im WifiConfig_StoredNetwork-Array oder -1 für fehler zurück. In diesem Fall errno wird auf den Fehlerwert festgelegt.

Anforderungen an das Anwendungsmanifest

Das Anwendungsmanifest muss die WifiConfig-Funktion enthalten.