Partilhar via

Função WifiConfig_AddDuplicateNetwork

  • Artigo

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

Adiciona uma nova rede que é um duplicado da rede especificada com o ID especificado. A nova rede tem o nome especificado atribuído e está desativada por predefinição.

int WifiConfig_AddDuplicateNetwork(int networkId, const char *configName);

Parâmetros

  • networkId O ID da rede a duplicar. WifiConfig_AddNetwork devolve o ID de rede.

  • configName Um ponteiro para uma matriz de bytes que contém o nome da configuração. A matriz tem de ser terminada por NULL e, no máximo, WIFICONFIG_CONFIG_NAME_MAX_LENGTH bytes, excluindo o caráter de terminação.

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.

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

  • EEXIST: o configName não é exclusivo.

  • EFAULT: o configName é NULO.

  • EINVAL: o networkId é inválido.

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

  • ENODEV: o networkId não corresponde a nenhuma das redes armazenadas.

  • ENOMEM: não existe memória suficiente para adicionar uma nova rede.

  • ERANGE: o configName tem menos de um caráter ou mais de WIFICONFIG_CONFIG_NAME_MAX_LENGTH carateres.

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 o ID da nova rede, ou -1 para a falha, caso em que errno está definido como o valor de erro. O ID de rede é zero ou um valor positivo.

Observações

A nova rede não está configurada e pode ser configurada com as funções WifiConfig_Set* . As alterações à configuração de rede têm efeito imediato, mas perdem-se quando o dispositivo é reiniciado, a menos que a função WifiConfig_PersistConfig seja chamada para guardar a configuração no armazenamento não complicado.

O número de redes que pode armazenar num dispositivo não é fixo, mas depende dos recursos disponíveis e da quantidade de armazenamento necessária para cada configuração de rede.

Requisitos do manifesto de aplicação

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