Função WifiConfig_AddDuplicateNetwork

  • Artigo

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

Adiciona uma nova rede que é uma duplicata da rede especificada com a ID especificada. A nova rede recebe o nome especificado e é desabilitada por padrão.

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

Parâmetros

  • networkId A ID da rede a ser duplicada. WifiConfig_AddNetwork retorna a ID da rede.

  • configName Um ponteiro para uma matriz de bytes que contém o nome da configuração. A matriz deve ser encerrada NULL e, no máximo, WIFICONFIG_CONFIG_NAME_MAX_LENGTH bytes, excluindo o caractere de término.

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.

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

  • EEXIST: o configName não é exclusivo.

  • EFAULT: o configName é NULL.

  • 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 há memória suficiente para adicionar uma nova rede.

  • ERANGE: o configName tem menos de um caractere ou mais de WIFICONFIG_CONFIG_NAME_MAX_LENGTH caracteres.

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 a ID da nova rede ou -1 para falha, nesse caso errno , é definido como o valor do erro. A 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 na configuração de rede são efetivas imediatamente, mas são perdidas quando o dispositivo é reiniciado, a menos que a função WifiConfig_PersistConfig seja chamada para salvar a configuração para armazenamento não involatile.

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

Requisitos de manifesto do aplicativo

O manifesto do aplicativo deve incluir o recurso WifiConfig.