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

# XNetworkingGetConnectivityHint

> XNetworkingGetConnectivityHint

# XNetworkingGetConnectivityHint

查询有关当前网络连接级别、数据限制、接口类型和网络初始化状态的设备范围信息。

## 语法

```cpp theme={null}
HRESULT XNetworkingGetConnectivityHint(
         XNetworkingConnectivityHint* connectivityHint
)
```

### 参数

*connectivityHint*   \_Out\_<br />类型：[XNetworkingConnectivityHint](/reference/networking/xnetworking/structs/xnetworkingconnectivityhint)\*

网络的当前设备范围状态。

### 返回值

类型：HRESULT

HRESULT 成功或错误代码。

## 备注

此函数返回有关网络连接级别、数据限制、有线与无线连接以及网络是否已初始化的设备范围信息。你可以使用 [XNetworkingRegisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged) 和 [XNetworkingUnregisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingunregisterconnectivityhintchanged) 函数侦听更改。

返回的 `XNetworkingConnectivityHint` 结构中的字段（`XNetworkingConnectivityHint::networkInitialized` 字段除外）是提示。它们是设备根据设备上网络流量的摘要对网络当前状态的尽力猜测。重要的是，这些字段不代表是否可连接到你特定游戏的终结点。我们建议在等待网络初始化完成后，你使用 WinSock 和/或 WinHTTP 尝试与你的终结点建立连接，无论 `XNetworkingConnectivityHint::connectivityLevelHint` 字段的状态如何。如果那些 API 随后失败，我们建议然后使用 `XNetworkingGetConnectivityHint` API 用于额外的 UI 和诊断报告目的。然后你应等待网络连接级别的变化后再重试。

有关网络初始化的详细信息，请参阅[网络初始化和连接](/build/console-features/networking/initialization-connectivity-networking)。

此方法查询调用进程内的本地状态并快速返回，因此可从时间敏感的上下文中安全调用。

## 要求

**头文件：** XNetworking.h

**库：** xgameruntime.lib

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

## 另请参阅

[XNetworkingRegisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged)<br />[XNetworkingUnregisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingunregisterconnectivityhintchanged)<br />[检测网络初始化状态](/build/console-features/networking/initialization-connectivity-networking)<br />[XNetworking](/reference/networking/xnetworking/xnetworking_members)


## Related topics

- [XNetworkingRegisterConnectivityHintChanged](/zh-CN/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged.md)
- [XNetworkingConnectivityHintChangedCallback](/zh-CN/reference/networking/xnetworking/functions/xnetworkingconnectivityhintchangedcallback.md)
- [XNetworkingUnregisterConnectivityHintChanged](/zh-CN/reference/networking/xnetworking/functions/xnetworkingunregisterconnectivityhintchanged.md)
- [XNetworkingConnectivityHint](/zh-CN/reference/networking/xnetworking/structs/xnetworkingconnectivityhint.md)
- [检测网络初始化状态](/zh-CN/build/console-features/networking/initialization-connectivity-networking.md)