Partilhar via


função WifiConfig_GetConnectedNetworkId

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

Obtém o ID de rede da rede atualmente ligada.

O ID de rede pode mudar à medida que as configurações de rede são adicionadas e removidas. Se o dispositivo tiver sido reiniciado ou as configurações de rede tiverem sido adicionadas ou removidas, a aplicação deverá obter o ID de rede atual antes de alterar quaisquer configurações de rede armazenadas.

int WifiConfig_GetConnectedNetworkId();

Parâmetros

Nenhum.

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.

  • ENOTCONN: o dispositivo não está atualmente ligado a nenhuma rede.

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

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

Qualquer outro errno também pode ser especificado; tais erros não são deterministas e não há garantias de que o mesmo comportamento será mantido através de atualizações do sistema.

Valor devolvido

Devolve o ID de rede da rede ligada ou -1 para a 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.