WifiConfig_SetConfigName-Funktion

  • Artikel

Header: #include <applibs/wificonfig.h>

Legt einen Namen für eine Netzwerkkonfiguration fest. Der Name kann als praktisches Handle zum Identifizieren einer Netzwerkkonfiguration verwendet werden. Es wird dringend empfohlen, dass dieser Name eindeutig ist.

Die Einstellung wird sofort wirksam, wird aber nicht über Geräteneustarts hinweg beibehalten, es sei denn, die WifiConfig_PersistConfig Funktion wird nach dieser Funktion aufgerufen.

static int WifiConfig_SetConfigName(int networkId, const char *configName);

Parameter

  • networkId Die ID des zu konfigurierenden Netzwerks. WifiConfig_AddNetwork gibt die Netzwerk-ID zurück.

  • configname Ein Zeiger auf ein Bytearray, das den Konfigurationsnamen enthält. Das Bytearray muss null beendet sein und kleiner oder gleich WIFICONFIG_CONFIG_NAME_MAX_LENGTH Bytes 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_CONFIG_NAME_MAX_LENGTH.

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

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

  • EINVAL: Der networkId Parameter ist ungültig.

  • ENODEV: Der networkId Parameter stimmt mit keiner der IDs der gespeicherten Netzwerke überein.

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 0 für erfolg 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.