> ## 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

定义当前设备级别的网络状态，包括网络连接级别、数据限制、接口类型和网络初始化状态。

## 语法

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

### 成员

*connectivityLevel*<br />类型：[XNetworkingConnectivityLevelHint](/reference/networking/xnetworking/enums/xnetworkingconnectivitylevelhint)

设备当前的尽力而为的连接级别。

*connectivityCost*<br />类型：[XNetworkingConnectivityCostHint](/reference/networking/xnetworking/enums/xnetworkingconnectivitycosthint)

对设备当前数据限制的尽力而为的分类。

*ianaInterfaceType*<br />类型：uint32\_t

WinSock 和 WinHTTP 到达 internet 时可能使用的当前接口类型。是 [IANA NDIS 接口类型](https://learn.microsoft.com/windows-hardware/drivers/network/ndis-interface-types)之一。

*networkInitialized*<br />类型：bool

指示网络当前是否已初始化。有关详细信息，请参阅[检索网络信息](/build/console-features/networking/initialization-connectivity-networking)中的[网络初始化](/build/console-features/networking/initialization-connectivity-networking)一节。

*approachingDataLimit*<br />类型：bool

指示设备是否接近超出其数据限制。

*overDataLimit*<br />类型：bool

指示设备是否已超出其数据限制。

*roaming*<br />类型：bool

指示设备是否处于漫游状态。

## 备注

在尝试使用任何网络或安全 API 之前，请确保 *networkInitialized* 成员返回 true。

<Note>
  尝试使用尚未初始化的网络的 XNetworking API 将导致调用失败和不可预测的行为。
</Note>

此结构体由 [XNetworkingGetConnectivityHint](/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint) API 返回，也可作为从注册流程返回的回调参数。有关 Microsoft 游戏开发工具包 (GDK) 游戏中的网络信息，请参阅[检索网络信息](/build/console-features/networking/initialization-connectivity-networking)。

返回的 `XNetworkingConnectivityHint` 结构体中的字段（`XNetworkingConnectivityHint::networkInitialized` 字段除外）都是提示。它们是设备基于对设备网络流量的汇总所做出的、关于当前网络状态的尽力而为的推断。重要的是，这些字段并不代表是否能够连接到你的特定游戏端点。我们建议：在等待网络初始化完成后，无论 `XNetworkingConnectivityHint::connectivityLevelHint` 字段的状态如何，都使用 WinSock 和/或 WinHTTP 尝试与端点建立连接。如果这些 API 随后失败，我们建议再使用 `XNetworkingGetConnectivityHint` API 来提供额外的 UI 与诊断报告信息。然后你应等待网络连接级别发生变化后再重试。

## 要求

**头文件：** XNetworking.h

**支持的平台：** Windows、XBOX One 系列主机和 XBOX Series 主机

## 另请参阅

[XNetworking](/reference/networking/xnetworking/xnetworking_members)


## Related topics

- [XNetworkingConnectivityHintChangedCallback](/zh-CN/reference/networking/xnetworking/functions/xnetworkingconnectivityhintchangedcallback.md)
- [XNetworkingGetConnectivityHint](/zh-CN/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint.md)
- [XNetworkingConnectivityCostHint](/zh-CN/reference/networking/xnetworking/enums/xnetworkingconnectivitycosthint.md)
- [XNetworkingConnectivityLevelHint](/zh-CN/reference/networking/xnetworking/enums/xnetworkingconnectivitylevelhint.md)
- [XNetworkingRegisterConnectivityHintChanged](/zh-CN/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged.md)