Compartilhar via

Função WifiConfig_StoreWpa2Network

  • Artigo

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

Importante

Essa função é obsoleta. Use WifiConfig_AddNetwork em vez disso.

Armazena uma rede Wi-Fi WPA2 que usa uma chave pré-compartilhada. Essa função não é thread safe.

Nota

Essa função falhará se uma rede com o mesmo SSID e chave pré-compartilhada já estiver armazenada. Consulte a seçã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 caracteres não especificada que identifica a rede Wi-Fi.

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

  • psk Um ponteiro para um buffer que contém a chave pré-compartilhada para a rede Wi-Fi.

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

Erros

Retorna -1 se um erro for encontrado e definir errno como o valor do erro.

  • EACCES: o manifesto do aplicativo não inclui o recurso WifiConfig.

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

  • EFAULT: o ssid ou psk é NULL.

  • ERANGE: o ssidLength parâmetro ou pskLength é 0 ou maior que 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: há muitas redes Wi-Fi para a configuração persistir; remova um e tente novamente.

Qualquer outro errno também pode ser especificado; esses erros não são determinísticos e o mesmo comportamento pode não ser mantido por meio de atualizações do sistema.

Valor retornado

Retorna 0 para êxito ou -1 para falha, nesse caso errno é definido como o valor do erro.

Requisitos de manifesto do aplicativo

O manifesto do aplicativo deve incluir o recurso WifiConfig.