Função Networking_GetInterfaceConnectionStatus
Cabeçalho: #include <applibs/networking.h>
Obtém a status de conexão de rede para uma interface de rede. Quando Networking_GetInterfaceConnectionStatus é chamado, o sistema operacional retorna o último status conhecido e tenta atualizar o status de interface especificado no enumeração Networking_InterfaceConnectionStatus.
O enumeração Networking_InterfaceConnectionStatus retornado reflete o último status conhecido da interface, conectividade de rede, endereço IP e conexão com a Internet. Quando Networking_GetInterfaceConnectionStatus é chamado, o sistema operacional tenta atualizar esses sinalizadores status e fazer uma chamada conforme http://www.msftconnecttest.com observado nos requisitos de rede do sistema operacional do Azure Sphere, a fim de determinar se o dispositivo tem conectividade com a Internet.
Um aplicativo pode tomar medidas com base no status Networking_InterfaceConnectionStatus_ConnectedToInternet, o que indica se o dispositivo está conectado à Internet. No entanto, por vários motivos, a conectividade de rede ou internet pode ser perdida entre o momento em que o status foi atualizado e a hora em que o aplicativo tenta se conectar à Internet. Portanto, o aplicativo deve incluir a lógica que permite escolhas inteligentes ao encontrar alterações na disponibilidade de rede e internet. O aplicativo deve lidar com erros de conexão e se adaptar de acordo.
Se o status retornado indicar que o dispositivo não está conectado à Internet, o aplicativo poderá chamar Networking_GetInterfaceConnectionStatus novamente para determinar quando o dispositivo status é alterado.
Se Networking_InterfaceConnectionStatus_ConnectedToInternet indicar que o dispositivo está conectado à Internet, o dispositivo não deverá sondar por status mais de uma vez a cada 90 segundos. Se essa conexão status função retornar repetidamente a indicação de que o dispositivo está conectado à Internet, o sistema operacional limitará o status marcar se o intervalo de votação for muito curto. O intervalo de sondagem de aplicativo recomendado é de uma solicitação/dois minutos.
int Networking_GetInterfaceConnectionStatus(const char *networkInterfaceName, Networking_InterfaceConnectionStatus *outStatus);
Parâmetros
networkInterfaceNameO nome da interface de rede.outStatusUm ponteiro para o Networking_InterfaceConnectionStatus enumeração que recebe a status de conexão de rede.
Erros
Retorna -1 se um erro for encontrado e definir errno como o valor do erro.
EFAULT: o
outStatusparâmetro é NULL.ENOENT: a
networkInterfaceNameinterface não existe.EAGAIN: a pilha de rede não está pronta.
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, -1 para falha, nesse caso errno é definido como o valor do erro.