Função WifiConfig_GetNetworkIdByConfigName

  • Artigo

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

Obtém a ID de rede para a configuração de rede com o nome fornecido. Use WifiConfig_SetConfigName para atribuir o nome da rede. A ID da rede pode ser alterada à medida que as configurações de rede são adicionadas e removidas, portanto, os aplicativos devem obter a ID da rede novamente antes de alterar uma configuração de rede armazenada.

int WifiConfig_GetNetworkIdByConfigName(const char *configName);

Parâmetros

  • configName Um ponteiro para o nome da configuração de rede. Esse nome foi definido usando WifiConfig_SetConfigName. A cadeia de caracteres 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_SSID_MAX_LENGTH.

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

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

  • ENODEV: a configuração de rede especificada não pode ser encontrada.

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 de rede da rede especificada (valor não negativo) ou -1 para falha, nesse caso errno é definido como o valor do erro. A ID de rede é passada para as funções WifiConfig_Setxxx como o identificador para que a rede seja configurada.

Requisitos de manifesto do aplicativo

O manifesto do aplicativo deve incluir o recurso WifiConfig.