WifiConfig_SetSecurityType-Funktion

  • Artikel

Header: #include <applibs/wificonfig.h>

Legt den Sicherheitstyp für ein Wi-Fi-Netzwerk fest.

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_SetSecurityType(int networkId, WifiConfig_Security_Type securityType);

Parameter

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

  • securityType Der Sicherheitstyp für das angegebene Netzwerk.

Fehler

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

  • EACCES: Das Anwendungsmanifest enthält nicht die WifiConfig- oder EnterpriseWifiConfig-Funktion. Die EnterpriseWifiConfig-Funktion ist erforderlich, wenn securityType WifiConfig_Security_Wpa2_EAP_TLS ist.

  • EINVAL: Der securityType Parameter ist ungültig.

  • 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 Funktion WifiConfig oder für EAP-TLS-Netzwerke die EnterpriseWifiConfig-Funktion enthalten.