Partilhar via

Função WifiConfig_GetNetworkIdByConfigName

  • Artigo

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

Obtém o ID de rede para a configuração de rede com o nome especificado. Utilize WifiConfig_SetConfigName para atribuir o nome da rede. O ID de rede pode mudar à medida que as configurações de rede são adicionadas e removidas, pelo que as aplicações devem obter novamente o ID de rede 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. Este nome foi definido com WifiConfig_SetConfigName. A cadeia de carateres 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_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: não é possível localizar a configuração de rede especificada.

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 de rede da rede especificada (valor não negativo) ou -1 para a falha, caso errno em que está definido como o valor de erro. O ID de rede é transmitido para as funções WifiConfig_Setxxx como o identificador da rede a ser configurada.

Requisitos do manifesto de aplicação

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