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.