> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XNetworkingConnectivityHint

> XNetworkingConnectivityHint

# 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

```cpp theme={null}
typedef struct XNetworkingConnectivityHint {
    XNetworkingConnectivityLevelHint connectivityLevel;
    XNetworkingConnectivityCostHint connectivityCost;
    uint32_t ianaInterfaceType;
    bool networkInitialized;
    bool approachingDataLimit;
    bool overDataLimit;
    bool roaming;
} XNetworkingConnectivityHint
```

### Membros

*connectivityLevel*<br />Tipo: [XNetworkingConnectivityLevelHint](/pt-BR/reference/networking/xnetworking/enums/xnetworkingconnectivitylevelhint)

O nível de conectividade atual do dispositivo, determinado com base no melhor esforço.

*connectivityCost*<br />Tipo: [XNetworkingConnectivityCostHint](/pt-BR/reference/networking/xnetworking/enums/xnetworkingconnectivitycosthint)

A classificação atual dos limites de dados do dispositivo, determinada com base no melhor esforço.

*ianaInterfaceType*<br />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](https://learn.microsoft.com/windows-hardware/drivers/network/ndis-interface-types).

*networkInitialized*<br />Tipo: bool

Determina se a rede está inicializada no momento.  Para obter mais informações, confira a seção [Inicialização da rede](/pt-BR/build/console-features/networking/initialization-connectivity-networking) de [Recuperando informações de rede](/pt-BR/build/console-features/networking/initialization-connectivity-networking).

*approachingDataLimit*<br />Tipo: bool

Determina se o dispositivo está perto de exceder seus limites de dados.

*overDataLimit*<br />Tipo: bool

Determina se o dispositivo excedeu seus limites de dados.

*roaming*<br />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.

<Note>
  Tentar usar as APIs do XNetworking com uma rede que não está inicializada resultará em chamadas com falha e comportamento imprevisível.
</Note>

Esta estrutura é retornada pela API [XNetworkingGetConnectivityHint](/pt-BR/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint) e pelo retorno de chamada do fluxo de registro. Para obter informações de rede em títulos do Microsoft Game Development Kit (GDK), confira [Recuperando informações de rede](/pt-BR/build/console-features/networking/initialization-connectivity-networking).

Os campos na estrutura `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.

## Requisitos

**Cabeçalho:** XNetworking.h

**Plataformas compatíveis:** Windows, consoles da família XBOX One e consoles XBOX Series

## Confira também

[XNetworking](/pt-BR/reference/networking/xnetworking/xnetworking_members)


## Related topics

- [XNetworkingConnectivityHint](/reference/networking/xnetworking/structs/xnetworkingconnectivityhint.md)
- [XNetworkingConnectivityHintChangedCallback](/reference/networking/xnetworking/functions/xnetworkingconnectivityhintchangedcallback.md)