Bibliothèques d’applications wificonfig.h
En-tête : #include <applibs/wificonfig.h>
L’en-tête Wificonfig des bibliothèques d’applications contient des fonctions et des types qui gèrent Wi-Fi configurations réseau sur un appareil.
Note
Pour utiliser ces fonctions, définissez WIFICONFIG_STRUCTS_VERSION avec la version de structure que vous utilisez. Actuellement, la seule version valide est 1 (définissez WIFICONFIG_STRUCTS_VERSION 1). Par la suite, vous pouvez utiliser les noms conviviaux des structures WifiConfig_, qui commencent par WifiConfig_.
Exigences du manifeste d’application
Vous ne pouvez appeler ces fonctions que si votre application dispose de la fonctionnalité WifiConfig dans le manifeste de l’application. La fonctionnalité EnterpriseWifiConfig est également requise si l’application gère des paramètres pour un réseau EAP-TLS.
Sécurité des threads
Ces fonctions ne sont pas thread-safe.
Concepts et exemples
- Connecter Azure Sphere au Wi-Fi
- Exemple : Wi-Fi
- Exemple : solution de référence de configuration de Wi-Fi et de contrôle d’appareil basée sur BLE
Fonctions
| Fonction | Description |
|---|---|
| WifiConfig_AddNetwork | Ajoute un réseau Wi-Fi à l’appareil et retourne l’ID du réseau. |
| WifiConfig_AddDuplicateNetwork | Ajoute un nouveau réseau qui est un doublon d’un réseau existant. |
| WifiConfig_ForgetAllNetworks | Supprime tous les réseaux Wi-Fi stockés de l’appareil. Déconnecte l’appareil de tout réseau connecté. |
| WifiConfig_ForgetNetwork | Obsolète: Cette fonction est obsolète. Utilisez WifiConfig_ForgetNetworkById à la place. |
| WifiConfig_ForgetNetworkById | Supprime un réseau Wi-Fi de l’appareil. |
| WiFiConfig_GetClientCertStoreIdentifier | Obtient l’identificateur du certificat client stocké pour un réseau. |
| WiFiConfig_GetClientIdentity | Obtient l’identité du client du réseau. |
| WifiConfig_GetConnectedNetworkId | Obtient l’ID du réseau actuellement connecté. |
| WifiConfig_GetCurrentNetwork | Obtient un réseau Wi-Fi connecté à l’appareil. |
| WifiConfig_GetNetworkDiagnostics | Obtient des informations sur la défaillance réseau la plus récente. |
| WifiConfig_GetNetworkIdByConfigName | Obtient l’ID réseau de la configuration réseau avec le nom donné. |
| WiFiConfig_GetRootCACertStoreIdentifier | Obtient l’identificateur du certificat d’autorité de certification racine stocké pour un réseau. |
| WifiConfig_GetScannedNetworks | Obtient les réseaux Wi-Fi trouvés par la dernière opération d’analyse. |
| WifiConfig_GetStoredNetworkCount | Obtient le nombre de réseaux Wi-Fi stockés sur l’appareil. |
| WifiConfig_GetStoredNetworks | Récupère tous les réseaux Wi-Fi stockés sur l’appareil. |
| WifiConfig_PersistConfig | Écrit la configuration réseau actuelle dans un stockage non volatile afin qu’elle persiste pendant un redémarrage de l’appareil. |
| WifiConfig_ReloadConfig | Recharge une configuration Wi-Fi. |
| WiFiConfig_SetClientCertStoreIdentifier | Définit l’identificateur du certificat client stocké pour un réseau. |
| WiFiConfig_SetClientIdentity | Définit l’identité du client pour un réseau. |
| WifiConfig_SetConfigName | Définit le nom d’une configuration réseau. Le nom peut être utilisé comme handle pratique pour identifier une configuration réseau. |
| WifiConfig_SetNetworkEnabled | Active ou désactive une configuration réseau Wi-Fi. |
| WifiConfig_SetPSK | Définit la clé pré-partagée (PSK) pour un réseau Wi-Fi. |
| WiFiConfig_SetRootCACertStoreIdentifier | Définit l’identificateur du certificat d’autorité de certification racine stocké pour un réseau. |
| WifiConfig_SetSecurityType | Définit le type de sécurité d’un réseau Wi-Fi. |
| WifiConfig_SetSsid | Définit le SSID d’un réseau Wi-Fi. |
| WifiConfig_SetTargetedScanEnabled | Active ou désactive l’analyse ciblée pour un réseau. |
| WifiConfig_StoreOpenNetwork | Obsolète: Cette fonction est obsolète. Utilisez WifiConfig_AddNetwork à la place. |
| WifiConfig_StoreWpa2Network | Obsolète: Cette fonction est obsolète. Utilisez WifiConfig_AddNetwork à la place. |
| WifiConfig_TriggerScanAndGetScannedNetworkCount | Démarre une analyse pour rechercher tous les réseaux Wi-Fi disponibles. |
Structs
| Struct | Description |
|---|---|
| WifiConfig_ClientIdentify | Identité cliente associée à un réseau. |
| WifiConfig_ConnectedNetwork | Les propriétés d’un réseau Wi-Fi connecté, qui représentent un jeu de services de base (BSS) 802.11. |
| WifiConfig_NetworkDiagnostics | Informations sur l’échec le plus récent de connexion à un réseau. |
| WifiConfig_ScannedNetwork | Les propriétés d’un réseau Wi-Fi analysé, qui représentent un BSS 802.11. |
| WifiConfig_StoredNetwork | Les propriétés d’un réseau Wi-Fi stocké, qui représentent un BSS 802.11. |
Enums
| Enum | Description |
|---|---|
| WifiConfig_Security | Paramètre de clé de sécurité pour un réseau Wi-Fi. |
Typedefs
| Typedef | Description |
|---|---|
| WifiConfig_Security_Type | Spécifie le type des valeurs des paramètres de sécurité pour l’énumération WifiConfig_Security . |