Partilhar via

Função WifiConfig_SetConfigName

  • Artigo

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

Define um nome para uma configuração de rede. O nome pode ser utilizado como um identificador conveniente para identificar uma configuração de rede. Recomenda-se vivamente que este nome seja exclusivo.

A definição tem efeito imediato, mas não persiste entre reinícios do dispositivo, a menos que a função WifiConfig_PersistConfig seja chamada após esta função.

static int WifiConfig_SetConfigName(int networkId, const char *configName);

Parâmetros

  • networkId O ID da rede a configurar. 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 de bytes tem de ser NULA terminada e ser menor ou igual a WIFICONFIG_CONFIG_NAME_MAX_LENGTH bytes (excluindo a 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.

  • EFAULT: o configName parâmetro é NULL.

  • ERANGE: o configName parâmetro é maior que WIFICONFIG_CONFIG_NAME_MAX_LENGTH.

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

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

  • EINVAL: o networkId parâmetro é inválido.

  • ENODEV: o networkId parâmetro não corresponde a nenhum dos IDs das redes armazenadas.

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.