Applibs wificonfig.h
Cabeçalho: #include <applibs/wificonfig.h>
O cabeçalho wificonfig do Applibs contém funções e tipos que gerenciam Wi-Fi configurações de rede em um dispositivo.
Nota
Para usar essas funções, defina WIFICONFIG_STRUCTS_VERSION com a versão de estrutura que você está usando. Atualmente, a única versão válida é 1 (definir WIFICONFIG_STRUCTS_VERSION 1). Depois disso, você pode usar os nomes amigáveis das estruturas WifiConfig_, que começam com WifiConfig_.
Requisitos de manifesto do aplicativo
Você só pode chamar essas funções se seu aplicativo tiver o recurso WifiConfig no manifesto do aplicativo. A funcionalidade EnterpriseWifiConfig também será necessária se o aplicativo gerenciar quaisquer configurações para uma rede EAP-TLS.
Segurança do thread
Essas funções não são thread safe.
Conceitos e exemplos
- Conectar o Azure Sphere ao Wi-Fi
- Exemplo: Wi-Fi
- Exemplo: solução de referência de Wi-Fi de Wi-Fi baseada em BLE e controle de dispositivo
Funções
| Função | Descrição |
|---|---|
| WifiConfig_AddNetwork | Adiciona uma rede Wi-Fi ao dispositivo e retorna a ID da rede. |
| WifiConfig_AddDuplicateNetwork | Adiciona uma nova rede que é uma duplicata de uma rede existente. |
| WifiConfig_ForgetAllNetworks | Remove todas as redes de Wi-Fi armazenadas do dispositivo. Desconecta o dispositivo de qualquer rede conectada. |
| WifiConfig_ForgetNetwork | Obsoleto: Essa função é obsoleta. Use WifiConfig_ForgetNetworkById em vez disso. |
| WifiConfig_ForgetNetworkById | Remove uma rede Wi-Fi do dispositivo. |
| WiFiConfig_GetClientCertStoreIdentifier | Obtém o identificador do certificado de cliente armazenado para uma rede. |
| WiFiConfig_GetClientIdentity | Obtém a identidade do cliente da rede. |
| WifiConfig_GetConnectedNetworkId | Obtém a ID da rede conectada no momento. |
| WifiConfig_GetCurrentNetwork | Obtém uma rede Wi-Fi conectada ao dispositivo. |
| WifiConfig_GetNetworkDiagnostics | Obtém informações sobre a falha de rede mais recente. |
| WifiConfig_GetNetworkIdByConfigName | Obtém a ID de rede para a configuração de rede com o nome fornecido. |
| WiFiConfig_GetRootCACertStoreIdentifier | Obtém o identificador do certificado de AC raiz armazenado para uma rede. |
| WifiConfig_GetScannedNetworks | Obtém as redes de Wi-Fi encontradas pela última operação de verificação. |
| WifiConfig_GetStoredNetworkCount | Obtém o número de redes de Wi-Fi armazenadas no dispositivo. |
| WifiConfig_GetStoredNetworks | Recupera todas as redes de Wi-Fi armazenadas no dispositivo. |
| WifiConfig_PersistConfig | Grava a configuração de rede atual em armazenamento não involatile para que ela persista em uma reinicialização do dispositivo. |
| WifiConfig_ReloadConfig | Recarrega uma configuração de Wi-Fi. |
| WiFiConfig_SetClientCertStoreIdentifier | Define o identificador para o certificado de cliente armazenado para uma rede. |
| WiFiConfig_SetClientIdentity | Define a identidade do cliente para uma rede. |
| WifiConfig_SetConfigName | Define o nome de uma configuração de rede. O nome pode ser usado como um identificador conveniente para identificar uma configuração de rede. |
| WifiConfig_SetNetworkEnabled | Habilita ou desabilita uma configuração de rede Wi-Fi. |
| WifiConfig_SetPSK | Define a chave pré-compartilhada (PSK) para uma rede Wi-Fi. |
| WiFiConfig_SetRootCACertStoreIdentifier | Define o identificador para o certificado de AC raiz armazenado para uma rede. |
| WifiConfig_SetSecurityType | Define o tipo de segurança para uma rede Wi-Fi. |
| WifiConfig_SetSsid | Define o SSID para uma rede Wi-Fi. |
| WifiConfig_SetTargetedScanEnabled | Habilita ou desabilita a verificação direcionada de uma rede. |
| WifiConfig_StoreOpenNetwork | Obsoleto: Essa função é obsoleta. Use WifiConfig_AddNetwork em vez disso. |
| WifiConfig_StoreWpa2Network | Obsoleto: Essa função é obsoleta. Use WifiConfig_AddNetwork em vez disso. |
| WifiConfig_TriggerScanAndGetScannedNetworkCount | Inicia uma verificação para localizar todas as redes de Wi-Fi disponíveis. |
Estruturas
| Struct | Descrição |
|---|---|
| WifiConfig_ClientIdentify | A identidade do cliente associada a uma rede.. |
| WifiConfig_ConnectedNetwork | As propriedades de uma rede Wi-Fi conectada, que representam um BSS (Conjunto de Serviços Básico) 802.11. |
| WifiConfig_NetworkDiagnostics | Informações sobre a falha mais recente em se conectar a uma rede. |
| WifiConfig_ScannedNetwork | As propriedades de uma rede de Wi-Fi digitalizada, que representam um BSS 802.11. |
| WifiConfig_StoredNetwork | As propriedades de uma rede de Wi-Fi armazenada, que representam um BSS 802.11. |
Enums
| Enum | Descrição |
|---|---|
| WifiConfig_Security | A configuração da chave de segurança para uma rede Wi-Fi. |
Typedefs
| Typedef | Descrição |
|---|---|
| WifiConfig_Security_Type | Especifica o tipo de valores de configurações de segurança para o WifiConfig_Security enumeração. |