WifiConfig_GetNetworkIdByConfigName-Funktion

  • Artikel

Header: #include <applibs/wificonfig.h>

Ruft die Netzwerk-ID für die Netzwerkkonfiguration mit dem angegebenen Namen ab. Verwenden Sie WifiConfig_SetConfigName , um den Netzwerknamen zuzuweisen. Die Netzwerk-ID kann sich ändern, wenn Netzwerkkonfigurationen hinzugefügt und entfernt werden, sodass Apps die Netzwerk-ID erneut abrufen sollten, bevor sie eine gespeicherte Netzwerkkonfiguration ändern.

int WifiConfig_GetNetworkIdByConfigName(const char *configName);

Parameter

  • configName Ein Zeiger auf den Namen der Netzwerkkonfiguration. Dieser Name wurde mithilfe von WifiConfig_SetConfigName festgelegt. Die Zeichenfolge muss null beendet sein und kleiner oder gleich WIFICONFIG_CONFIG_NAME_MAX_LENGTH Byte sein (ohne die Beendigung).

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

  • ERANGE: Der configName Parameter ist größer als WIFICONFIG_SSID_MAX_LENGTH.

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

  • ENETDOWN: Die Wi-Fi Netzwerkschnittstelle ist nicht verfügbar.

  • ENODEV: Die angegebene Netzwerkkonfiguration wurde nicht gefunden.

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 Netzwerk-ID des angegebenen Netzwerks (nicht negativer Wert) oder -1 für Fehler zurück. In diesem Fall errno wird auf den Fehlerwert festgelegt. Die Netzwerk-ID wird an die WifiConfig_Setxxx fungiert als Bezeichner für das zu konfigurierende Netzwerk.

Anforderungen an das Anwendungsmanifest

Das Anwendungsmanifest muss die WifiConfig-Funktion enthalten.