XNetworkingConnectivityHint
Define o estado atual da rede em todo o dispositivo, incluindo o nível de conectividade de rede, os limites de dados, o tipo de interface e o estado de inicialização da rede.Sintaxe
Membros
connectivityLevelTipo: XNetworkingConnectivityLevelHint O nível de conectividade atual do dispositivo, determinado com base no melhor esforço. connectivityCost
Tipo: XNetworkingConnectivityCostHint A classificação atual dos limites de dados do dispositivo, determinada com base no melhor esforço. ianaInterfaceType
Tipo: uint32_t O tipo de interface atual que provavelmente será usado pelo WinSock e pelo WinHTTP para acessar a Internet. Um dos tipos de interface NDIS da IANA. networkInitialized
Tipo: bool Determina se a rede está inicializada no momento. Para obter mais informações, confira a seção Inicialização da rede de Recuperando informações de rede. approachingDataLimit
Tipo: bool Determina se o dispositivo está perto de exceder seus limites de dados. overDataLimit
Tipo: bool Determina se o dispositivo excedeu seus limites de dados. roaming
Tipo: bool Determina se o dispositivo está em roaming ou não.
Comentários
Verifique se o membro networkInitialized retorna true antes de tentar usar qualquer API de rede ou de segurança.Tentar usar as APIs do XNetworking com uma rede que não está inicializada resultará em chamadas com falha e comportamento imprevisível.
XNetworkingConnectivityHint retornada (exceto o campo XNetworkingConnectivityHint::networkInitialized) são dicas. Eles são estimativas de melhor esforço feitas pelo dispositivo sobre o estado atual da rede com base em um resumo do tráfego de rede no dispositivo. É importante observar que esses campos não indicam se há conectividade com os pontos de extremidade específicos do seu título. Recomendamos que, após aguardar a inicialização da rede, você use o WinSock e/ou o WinHTTP para tentar estabelecer uma conexão com seu ponto de extremidade, independentemente do estado do campo XNetworkingConnectivityHint::connectivityLevelHint. Se essas APIs falharem posteriormente, recomendamos que você use a API XNetworkingGetConnectivityHint para fins adicionais de interface do usuário e relatórios de diagnóstico. Em seguida, você deve aguardar uma alteração no nível de conectividade de rede antes de tentar novamente.