Função WifiConfig_GetCurrentNetwork
Cabeçalho: #include <applibs/wificonfig.h>
Obtém uma rede Wi-Fi que está ligada ao dispositivo. Esta função não é segura para threads.
int WifiConfig_GetCurrentNetwork(WifiConfig_ConnectedNetwork * connectedNetwork);
Parâmetros
-
connectedNetwork
Um ponteiro para uma estrutura de WifiConfig_ConnectedNetwork que devolve a rede Wi-Fi ligada.
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
ssid
é NULO.ENODATA: o dispositivo não está atualmente ligado a nenhuma rede.
EINVAL: a versão da
storedNetwork
estrutura ou é inválida.EAGAIN: o dispositivo Wi-Fi ainda não está pronto.
ENETDOWN: a interface de rede Wi-Fi não está disponível.
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.