Compartilhar 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 usado como um identificador conveniente para identificar uma configuração de rede. É altamente recomendável que esse nome seja exclusivo.

A configuração é efetiva imediatamente, mas não persistirá entre reinicializações de dispositivo, a menos que a função WifiConfig_PersistConfig seja chamada após essa função.

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

Parâmetros

  • networkId A ID da rede a ser configurada. 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 de bytes deve ser encerrada NULL e ser menor ou igual a WIFICONFIG_CONFIG_NAME_MAX_LENGTH bytes (excluindo a terminação).

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.

  • 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 nenhuma das IDs das redes armazenadas.

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.