Applibs wificonfig.h
Sidhuvud: #include <applibs/wificonfig.h>
Rubriken Applibs wificonfig innehåller funktioner och typer som hanterar Wi-Fi nätverkskonfigurationer på en enhet.
Observera
Om du vill använda de här funktionerna definierar du WIFICONFIG_STRUCTS_VERSION med den strukturversion du använder. För närvarande är den enda giltiga versionen 1 (definiera WIFICONFIG_STRUCTS_VERSION 1). Därefter kan du använda de beskrivande namnen på de WifiConfig_ strukturerna, som börjar med WifiConfig_.
Krav för programmanifest
Du kan bara anropa de här funktionerna om programmet har wificonfig-funktionen i programmanifestet. EnterpriseWifiConfig-funktionen krävs också om programmet hanterar några inställningar för ett EAP-TLS-nätverk.
Trådsäkerhet
De här funktionerna är inte trådsäkra.
Koncept och exempel
- Ansluta Azure Sphere till Wi-Fi
- Exempel: Wi-Fi
- Exempel: BLE-baserad Wi-Fi konfigurations- och enhetskontrollreferenslösning
Funktioner
| Funktion | Beskrivning |
|---|---|
| WifiConfig_AddNetwork | Lägger till ett Wi-Fi nätverk på enheten och returnerar nätverkets ID. |
| WifiConfig_AddDuplicateNetwork | Lägger till ett nytt nätverk som är en dubblett av ett befintligt nätverk. |
| WifiConfig_ForgetAllNetworks | Tar bort alla lagrade Wi-Fi nätverk från enheten. Kopplar bort enheten från ett anslutet nätverk. |
| WifiConfig_ForgetNetwork | Föråldrade: Den här funktionen är föråldrad. Använd WifiConfig_ForgetNetworkById i stället. |
| WifiConfig_ForgetNetworkById | Tar bort ett Wi-Fi nätverk från enheten. |
| WiFiConfig_GetClientCertStoreIdentifier | Hämtar identifieraren för det lagrade klientcertifikatet för ett nätverk. |
| WiFiConfig_GetClientIdentity | Hämtar nätverkets klientidentitet. |
| WifiConfig_GetConnectedNetworkId | Hämtar ID för det anslutna nätverket. |
| WifiConfig_GetCurrentNetwork | Hämtar ett Wi-Fi nätverk som är anslutet till enheten. |
| WifiConfig_GetNetworkDiagnostics | Hämtar information om det senaste nätverksfelet. |
| WifiConfig_GetNetworkIdByConfigName | Hämtar nätverks-ID:t för nätverkskonfigurationen med det angivna namnet. |
| WiFiConfig_GetRootCACertStoreIdentifier | Hämtar identifieraren för det lagrade rotcertifikatutfärdarcertifikatet för ett nätverk. |
| WifiConfig_GetScannedNetworks | Hämtar de Wi-Fi nätverk som hittades vid den senaste genomsökningen. |
| WifiConfig_GetStoredNetworkCount | Hämtar antalet lagrade Wi-Fi nätverk på enheten. |
| WifiConfig_GetStoredNetworks | Hämtar alla lagrade Wi-Fi nätverk på enheten. |
| WifiConfig_PersistConfig | Skriver den aktuella nätverkskonfigurationen till icke-volatil lagring så att den finns kvar vid en omstart av enheten. |
| WifiConfig_ReloadConfig | Läser in en Wi-Fi konfiguration igen. |
| WiFiConfig_SetClientCertStoreIdentifier | Anger identifieraren för det lagrade klientcertifikatet för ett nätverk. |
| WiFiConfig_SetClientIdentity | Anger klientidentiteten för ett nätverk. |
| WifiConfig_SetConfigName | Anger namn för en nätverkskonfiguration. Namnet kan användas som ett praktiskt handtag för att identifiera en nätverkskonfiguration. |
| WifiConfig_SetNetworkEnabled | Aktiverar eller inaktiverar en Wi-Fi nätverkskonfiguration. |
| WifiConfig_SetPSK | Anger den fördelade nyckeln (PSK) för ett Wi-Fi nätverk. |
| WiFiConfig_SetRootCACertStoreIdentifier | Anger identifieraren för det lagrade rotcertifikatutfärdarcertifikatet för ett nätverk. |
| WifiConfig_SetSecurityType | Anger säkerhetstypen för ett Wi-Fi nätverk. |
| WifiConfig_SetSsid | Anger SSID för ett Wi-Fi nätverk. |
| WifiConfig_SetTargetedScanEnabled | Aktiverar eller inaktiverar riktad sökning efter ett nätverk. |
| WifiConfig_StoreOpenNetwork | Föråldrade: Den här funktionen är föråldrad. Använd WifiConfig_AddNetwork i stället. |
| WifiConfig_StoreWpa2Network | Föråldrade: Den här funktionen är föråldrad. Använd WifiConfig_AddNetwork i stället. |
| WifiConfig_TriggerScanAndGetScannedNetworkCount | Startar en genomsökning för att hitta alla tillgängliga Wi-Fi nätverk. |
Structs
| Struct | Beskrivning |
|---|---|
| WifiConfig_ClientIdentify | Klientidentiteten som är kopplad till ett nätverk.. |
| WifiConfig_ConnectedNetwork | Egenskaperna för ett anslutet Wi-Fi nätverk, som representerar en 802.11-tjänstuppsättning (BSS). |
| WifiConfig_NetworkDiagnostics | Information om det senaste felet med att ansluta till ett nätverk. |
| WifiConfig_ScannedNetwork | Egenskaperna för ett skannat Wi-Fi-nätverk, som representerar 802.11 BSS. |
| WifiConfig_StoredNetwork | Egenskaperna för ett lagrat Wi-Fi nätverk, som representerar 802.11 BSS. |
Enums
| Enum | Beskrivning |
|---|---|
| WifiConfig_Security | Säkerhetsnyckelinställningen för ett Wi-Fi nätverk. |
Typedefs
| Typedef | Beskrivning |
|---|---|
| WifiConfig_Security_Type | Anger typen av säkerhetsinställningsvärden för WifiConfig_Security uppräkning. |