Applibs wificonfig.h
Intestazione: #include <applibs/wificonfig.h>
L'intestazione Applibs wificonfig contiene funzioni e tipi che gestiscono Wi-Fi configurazioni di rete in un dispositivo.
Nota
Per usare queste funzioni, definire WIFICONFIG_STRUCTS_VERSION con la versione struttura in uso. Attualmente, l'unica versione valida è 1 (definisci WIFICONFIG_STRUCTS_VERSION 1). Successivamente, è possibile usare i nomi descrittivi delle strutture di WifiConfig_, che iniziano con WifiConfig_.
Requisiti del manifesto dell'applicazione
È possibile chiamare queste funzioni solo se l'applicazione dispone della funzionalità WifiConfig nel manifesto dell'applicazione. La funzionalità EnterpriseWifiConfig è necessaria anche se l'applicazione gestisce le impostazioni per una rete EAP-TLS.
Thread safety
Queste funzioni non sono thread-safe.
Concetti ed esempi
- Connettere Azure Sphere al Wi-Fi
- Esempio: Wi-Fi
- Esempio: Soluzione di riferimento per l'installazione di Wi-Fi basato su BLE e il controllo del dispositivo
Funzioni
| Funzione | Descrizione |
|---|---|
| WifiConfig_AddNetwork | Aggiunge una rete Wi-Fi al dispositivo e restituisce l'ID della rete. |
| WifiConfig_AddDuplicateNetwork | Aggiunge una nuova rete duplicata di una rete esistente. |
| WifiConfig_ForgetAllNetworks | Rimuove dal dispositivo tutte le reti Wi-Fi archiviate. Disconnette il dispositivo da qualsiasi rete connessa. |
| WifiConfig_ForgetNetwork | Obsoleto: Questa funzione è obsoleta. Usare invece WifiConfig_ForgetNetworkById . |
| WifiConfig_ForgetNetworkById | Rimuove una rete Wi-Fi dal dispositivo. |
| WiFiConfig_GetClientCertStoreIdentifier | Ottiene l'identificatore del certificato client archiviato per una rete. |
| WiFiConfig_GetClientIdentity | Ottiene l'identità client della rete. |
| WifiConfig_GetConnectedNetworkId | Ottiene l'ID della rete attualmente connessa. |
| WifiConfig_GetCurrentNetwork | Ottiene una rete Wi-Fi connessa al dispositivo. |
| WifiConfig_GetNetworkDiagnostics | Ottiene informazioni sull'errore di rete più recente. |
| WifiConfig_GetNetworkIdByConfigName | Ottiene l'ID di rete per la configurazione di rete con il nome specificato. |
| WiFiConfig_GetRootCACertStoreIdentifier | Ottiene l'identificatore del certificato CA radice archiviato per una rete. |
| WifiConfig_GetScannedNetworks | Ottiene le reti Wi-Fi trovate dall'ultima operazione di analisi. |
| WifiConfig_GetStoredNetworkCount | Ottiene il numero di reti Wi-Fi archiviate nel dispositivo. |
| WifiConfig_GetStoredNetworks | Recupera tutte le reti Wi-Fi archiviate nel dispositivo. |
| WifiConfig_PersistConfig | Scrive la configurazione di rete corrente in un archivio nonvolatile in modo che persista durante un riavvio del dispositivo. |
| WifiConfig_ReloadConfig | Ricarica una configurazione di Wi-Fi. |
| WiFiConfig_SetClientCertStoreIdentifier | Imposta l'identificatore del certificato client archiviato per una rete. |
| WiFiConfig_SetClientIdentity | Imposta l'identità client per una rete. |
| WifiConfig_SetConfigName | Imposta il nome per una configurazione di rete. Il nome può essere usato come pratico handle per identificare una configurazione di rete. |
| WifiConfig_SetNetworkEnabled | Abilita o disabilita una configurazione di rete Wi-Fi. |
| WifiConfig_SetPSK | Imposta la chiave pre-condivisa (PSK) per una rete Wi-Fi. |
| WiFiConfig_SetRootCACertStoreIdentifier | Imposta l'identificatore del certificato CA radice archiviato per una rete. |
| WifiConfig_SetSecurityType | Imposta il tipo di sicurezza per una rete Wi-Fi. |
| WifiConfig_SetSsid | Imposta l'SSID per una rete Wi-Fi. |
| WifiConfig_SetTargetedScanEnabled | Abilita o disabilita l'analisi mirata per una rete. |
| WifiConfig_StoreOpenNetwork | Obsoleto: Questa funzione è obsoleta. Usare invece WifiConfig_AddNetwork . |
| WifiConfig_StoreWpa2Network | Obsoleto: Questa funzione è obsoleta. Usare invece WifiConfig_AddNetwork . |
| WifiConfig_TriggerScanAndGetScannedNetworkCount | Avvia un'analisi per trovare tutte le reti Wi-Fi disponibili. |
Strutture
| Struct | Descrizione |
|---|---|
| WifiConfig_ClientIdentify | Identità client associata a una rete. |
| WifiConfig_ConnectedNetwork | Proprietà di una rete Wi-Fi connessa, che rappresenta un set di servizi di base 802.11 ( BSS). |
| WifiConfig_NetworkDiagnostics | Informazioni sull'errore più recente di connessione a una rete. |
| WifiConfig_ScannedNetwork | Proprietà di una rete Wi-Fi analizzata, che rappresenta un BSS 802.11. |
| WifiConfig_StoredNetwork | Le proprietà di una rete Wi-Fi archiviata, che rappresentano un BSS 802.11. |
Enumerazioni
| Enum | Descrizione |
|---|---|
| WifiConfig_Security | Impostazione della chiave di sicurezza per una rete Wi-Fi. |
Typedef
| Typedef | Descrizione |
|---|---|
| WifiConfig_Security_Type | Specifica il tipo dei valori delle impostazioni di sicurezza per l'enumerazione WifiConfig_Security . |