Applibs wificonfig.h
Cabeçalho: #include <applibs/wificonfig.h>
O cabeçalho wificonfig applibs contém funções e tipos que gerem Wi-Fi configurações de rede num dispositivo.
Nota
Para utilizar estas funções, defina WIFICONFIG_STRUCTS_VERSION com a versão de estrutura que está a utilizar. Atualmente, a única versão válida é 1 (defina WIFICONFIG_STRUCTS_VERSION 1). A partir daí, pode utilizar os nomes amigáveis das estruturas de WifiConfig_, que começam com WifiConfig_.
Requisitos do manifesto de aplicação
Só pode chamar estas funções se a sua aplicação tiver a capacidade WifiConfig no manifesto da aplicação. A capacidade EnterpriseWifiConfig também é necessária se a aplicação gerir quaisquer definições para uma rede EAP-TLS.
Segurança de threads
Estas funções não são seguras para threads.
Conceitos e exemplos
- Ligar o Azure Sphere ao Wi-Fi
- Exemplo: Wi-Fi
- Exemplo: solução de referência de configuração Wi-Fi e controlo de dispositivos baseada em BLE
Funções
| Função | Descrição |
|---|---|
| WifiConfig_AddNetwork | Adiciona uma rede Wi-Fi ao dispositivo e devolve o ID da rede. |
| WifiConfig_AddDuplicateNetwork | Adiciona uma nova rede que é um duplicado de uma rede existente. |
| WifiConfig_ForgetAllNetworks | Remove todas as redes de Wi-Fi armazenadas do dispositivo. Desliga o dispositivo de qualquer rede ligada. |
| WifiConfig_ForgetNetwork | Obsoleto: Esta função é obsoleta. Em alternativa , utilize WifiConfig_ForgetNetworkById . |
| WifiConfig_ForgetNetworkById | Remove uma rede Wi-Fi do dispositivo. |
| WiFiConfig_GetClientCertStoreIdentifier | Obtém o identificador do certificado de cliente armazenado de uma rede. |
| WiFiConfig_GetClientIdentity | Obtém a identidade de cliente da rede. |
| WifiConfig_GetConnectedNetworkId | Obtém o ID da rede atualmente ligada. |
| WifiConfig_GetCurrentNetwork | Obtém uma rede Wi-Fi que está ligada ao dispositivo. |
| WifiConfig_GetNetworkDiagnostics | Obtém informações sobre a falha de rede mais recente. |
| WifiConfig_GetNetworkIdByConfigName | Obtém o ID de rede para a configuração de rede com o nome especificado. |
| WiFiConfig_GetRootCACertStoreIdentifier | Obtém o identificador do certificado de AC de Raiz armazenado para uma rede. |
| WifiConfig_GetScannedNetworks | Obtém as redes Wi-Fi encontradas pela última operação de análise. |
| WifiConfig_GetStoredNetworkCount | Obtém o número de redes Wi-Fi armazenadas no dispositivo. |
| WifiConfig_GetStoredNetworks | Obtém todas as redes de Wi-Fi armazenadas no dispositivo. |
| WifiConfig_PersistConfig | Escreve a configuração de rede atual no armazenamento não complicado para que persista durante um reinício do dispositivo. |
| WifiConfig_ReloadConfig | Recarrega uma configuração de Wi-Fi. |
| WiFiConfig_SetClientCertStoreIdentifier | Define o identificador do certificado de cliente armazenado para uma rede. |
| WiFiConfig_SetClientIdentity | Define a identidade do cliente de uma rede. |
| WifiConfig_SetConfigName | Define o nome de uma configuração de rede. O nome pode ser utilizado como um identificador conveniente para identificar uma configuração de rede. |
| WifiConfig_SetNetworkEnabled | Ativa ou desativa uma configuração de rede Wi-Fi. |
| WifiConfig_SetPSK | Define a chave pré-partilhada (PSK) para uma rede Wi-Fi. |
| WiFiConfig_SetRootCACertStoreIdentifier | Define o identificador do certificado de AC de Raiz armazenado para uma rede. |
| WifiConfig_SetSecurityType | Define o tipo de segurança de uma rede Wi-Fi. |
| WifiConfig_SetSsid | Define o SSID de uma rede Wi-Fi. |
| WifiConfig_SetTargetedScanEnabled | Ativa ou desativa a análise direcionada para uma rede. |
| WifiConfig_StoreOpenNetwork | Obsoleto: Esta função é obsoleta. Em alternativa , utilize WifiConfig_AddNetwork . |
| WifiConfig_StoreWpa2Network | Obsoleto: Esta função é obsoleta. Em alternativa , utilize WifiConfig_AddNetwork . |
| WifiConfig_TriggerScanAndGetScannedNetworkCount | Inicia uma análise para localizar todas as redes Wi-Fi disponíveis. |
Estruturas
| Estruturar | Descrição |
|---|---|
| WifiConfig_ClientIdentify | A identidade do cliente associada a uma rede. |
| WifiConfig_ConnectedNetwork | As propriedades de uma rede Wi-Fi ligada, que representam um Conjunto de Serviços Básico (BSS) 802.11. |
| WifiConfig_NetworkDiagnostics | Informações sobre a falha mais recente ao ligar 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 Wi-Fi armazenada, que representam um 802.11 BSS. |
Enumerações
| Enumeração | Descrição |
|---|---|
| WifiConfig_Security | A definição da chave de segurança para uma rede Wi-Fi. |
Typedefs
| Typedef | Descrição |
|---|---|
| WifiConfig_Security_Type | Especifica o tipo de valores de definições de segurança para a enumeração WifiConfig_Security . |