Partilhar via

Função WifiConfig_StoreWpa2Network

  • Artigo

Cabeçalho: #include <applibs/wificonfig.h>

Importante

Esta função é obsoleta. Em alternativa , utilize WifiConfig_AddNetwork .

Armazena uma rede WPA2 Wi-Fi que utiliza uma chave pré-partilhada. Esta função não é segura para threads.

Nota

Esta função falhará se uma rede com o mesmo SSID e chave pré-partilhada já estiver armazenada. Veja a secção de erro (EEXIST).

int WifiConfig_StoreWpa2Network(const uint8_t * ssid, size_t ssidLength, const char * psk, size_t pskLength);

Parâmetros

  • ssid Um ponteiro para uma matriz de bytes SSID com codificação de carateres não especificada que identifica o Wi-Fi rede.

  • ssidLength O número de bytes no SSID da rede Wi-Fi.

  • psk Um ponteiro para uma memória intermédia que contém a chave pré-partilhada da rede Wi-Fi.

  • pskLength O comprimento da chave pré-partilhada para a rede Wi-Fi.

Erros

Devolve -1 se for encontrado um erro e define errno para o valor de erro.

  • EACCES: o manifesto da aplicação não inclui a capacidade WifiConfig.

  • EEXIST: já existe uma rede de Wi-Fi armazenada que tem o mesmo SSID e utiliza o WPA2.

  • EFAULT: o ssid ou psk é NULO.

  • ERANGE: o ssidLength parâmetro ou pskLength é 0 ou superior a WIFICONFIG_SSID_MAX_LENGTH e WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE.

  • EAGAIN: o dispositivo Wi-Fi ainda não está pronto.

  • ENETDOWN: a interface de rede Wi-Fi não está disponível.

  • ENOSPC: existem demasiadas redes Wi-Fi para que a configuração persista; remova uma e tente novamente.

Também pode ser especificado qualquer outro errno ; esses erros não são deterministas e o mesmo comportamento pode não ser retido através de atualizações do sistema.

Valor devolvido

Devolve 0 para êxito ou -1 para falha, caso errno em que está definido como o valor de erro.

Requisitos do manifesto de aplicação

O manifesto da aplicação tem de incluir a capacidade WifiConfig.