Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Header: #include <applibs/wificonfig.h>
Der Applibs wificonfig-Header enthält Funktionen und Typen, die Wi-Fi Netzwerkkonfigurationen auf einem Gerät verwalten.
Hinweis
Um diese Funktionen zu verwenden, definieren Sie WIFICONFIG_STRUCTS_VERSION mit der von Ihnen verwendeten Strukturversion. Derzeit ist die einzige gültige Version 1 (definieren Sie WIFICONFIG_STRUCTS_VERSION 1). Anschließend können Sie die Anzeigenamen der WifiConfig_ Strukturen verwenden, die mit WifiConfig_ beginnen.
Anforderungen an das Anwendungsmanifest
Sie können diese Funktionen nur aufrufen, wenn Ihre Anwendung über die WifiConfig-Funktion im Anwendungsmanifest verfügt. Die EnterpriseWifiConfig-Funktion ist auch erforderlich, wenn die Anwendung Einstellungen für ein EAP-TLS-Netzwerk verwaltet.
Threadsicherheit
Diese Funktionen sind nicht threadsicher.
Konzepte und Beispiele
- Verbinden von Azure Sphere mit WLAN
- Beispiel: WLAN
- Beispiel: BLE-basierte Wi-Fi-Setup- und Gerätesteuerungsreferenzlösung
Funktionen
| Funktion | Beschreibung |
|---|---|
| WifiConfig_AddNetwork | Fügt dem Gerät ein Wi-Fi Netzwerk hinzu und gibt die ID des Netzwerks zurück. |
| WifiConfig_AddDuplicateNetwork | Fügt ein neues Netzwerk hinzu, das ein Duplikat eines vorhandenen Netzwerks ist. |
| WifiConfig_ForgetAllNetworks | Entfernt alle gespeicherten Wi-Fi Netzwerke vom Gerät. Trennt das Gerät von einem verbundenen Netzwerk. |
| WifiConfig_ForgetNetwork | Veraltet: Diese Funktion ist veraltet. Verwenden Sie stattdessen WifiConfig_ForgetNetworkById . |
| WifiConfig_ForgetNetworkById | Entfernt ein Wi-Fi Netzwerk vom Gerät. |
| WiFiConfig_GetClientCertStoreIdentifier | Ruft den Bezeichner des gespeicherten Clientzertifikats für ein Netzwerk ab. |
| WiFiConfig_GetClientIdentity | Ruft die Clientidentität des Netzwerks ab. |
| WifiConfig_GetConnectedNetworkId | Ruft die ID des aktuell verbundenen Netzwerks ab. |
| WifiConfig_GetCurrentNetwork | Ruft ein Wi-Fi Netzwerk ab, das mit dem Gerät verbunden ist. |
| WifiConfig_GetNetworkDiagnostics | Ruft Informationen zum letzten Netzwerkfehler ab. |
| WifiConfig_GetNetworkIdByConfigName | Ruft die Netzwerk-ID für die Netzwerkkonfiguration mit dem angegebenen Namen ab. |
| WiFiConfig_GetRootCACertStoreIdentifier | Ruft den Bezeichner des gespeicherten Zertifikats der Stammzertifizierungsstelle für ein Netzwerk ab. |
| WifiConfig_GetScannedNetworks | Ruft die Wi-Fi Netzwerke ab, die beim letzten Scanvorgang gefunden wurden. |
| WifiConfig_GetStoredNetworkCount | Ruft die Anzahl der gespeicherten Wi-Fi Netzwerken auf dem Gerät ab. |
| WifiConfig_GetStoredNetworks | Ruft alle gespeicherten Wi-Fi Netzwerke auf dem Gerät ab. |
| WifiConfig_PersistConfig | Schreibt die aktuelle Netzwerkkonfiguration in nicht flüchtigen Speicher, sodass sie bei einem Geräteneustart beibehalten wird. |
| WifiConfig_ReloadConfig | Lädt eine Wi-Fi-Konfiguration neu. |
| WiFiConfig_SetClientCertStoreIdentifier | Legt den Bezeichner für das gespeicherte Clientzertifikat für ein Netzwerk fest. |
| WiFiConfig_SetClientIdentity | Legt die Clientidentität für ein Netzwerk fest. |
| WifiConfig_SetConfigName | Legt den Namen für eine Netzwerkkonfiguration fest. Der Name kann als praktisches Handle zum Identifizieren einer Netzwerkkonfiguration verwendet werden. |
| WifiConfig_SetNetworkEnabled | Aktiviert oder deaktiviert eine Wi-Fi Netzwerkkonfiguration. |
| WifiConfig_SetPSK | Legt den vorinstallierten Schlüssel (Pre-Shared Key, PSK) für ein Wi-Fi-Netzwerk fest. |
| WiFiConfig_SetRootCACertStoreIdentifier | Legt den Bezeichner für das gespeicherte Zertifikat der Stammzertifizierungsstelle für ein Netzwerk fest. |
| WifiConfig_SetSecurityType | Legt den Sicherheitstyp für ein Wi-Fi-Netzwerk fest. |
| WifiConfig_SetSsid | Legt die SSID für ein Wi-Fi-Netzwerk fest. |
| WifiConfig_SetTargetedScanEnabled | Aktiviert oder deaktiviert die gezielte Überprüfung für ein Netzwerk. |
| WifiConfig_StoreOpenNetwork | Veraltet: Diese Funktion ist veraltet. Verwenden Sie stattdessen WifiConfig_AddNetwork . |
| WifiConfig_StoreWpa2Network | Veraltet: Diese Funktion ist veraltet. Verwenden Sie stattdessen WifiConfig_AddNetwork . |
| WifiConfig_TriggerScanAndGetScannedNetworkCount | Startet eine Überprüfung, um alle verfügbaren Wi-Fi Netzwerke zu finden. |
Strukturen
| Struktur | Beschreibung |
|---|---|
| WifiConfig_ClientIdentify | Die einem Netzwerk zugeordnete Clientidentität. |
| WifiConfig_ConnectedNetwork | Die Eigenschaften eines verbundenen Wi-Fi Netzwerks, die einen 802.11 Basic Service Set (BSS) darstellen. |
| WifiConfig_NetworkDiagnostics | Informationen zum letzten Fehler beim Herstellen einer Verbindung mit einem Netzwerk. |
| WifiConfig_ScannedNetwork | Die Eigenschaften eines gescannten Wi-Fi Netzwerks, das eine 802.11 BSS darstellt. |
| WifiConfig_StoredNetwork | Die Eigenschaften eines gespeicherten Wi-Fi Netzwerks, die eine 802.11 BSS darstellen. |
Enumerationen
| Enum | Beschreibung |
|---|---|
| WifiConfig_Security | Die Sicherheitsschlüsseleinstellung für ein Wi-Fi Netzwerk. |
Typdefinitionen
| Typedef | Beschreibung |
|---|---|
| WifiConfig_Security_Type | Gibt den Typ der Sicherheitseinstellungswerte für die WifiConfig_Security-Enumeration an. |