Applibs wificonfig.h
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. |