XNetworkingGetConnectivityHint

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

语法

HRESULT XNetworkingGetConnectivityHint(
         XNetworkingConnectivityHint* connectivityHint
)

参数

connectivityHint _Out_
类型：XNetworkingConnectivityHint*

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

返回值

类型：HRESULT

HRESULT 成功或错误代码。

备注

此函数返回设备范围的有关网络连接级别、数据限制、有线和无线连接以及网络是否初始化等信息。 您可以使用 XNetworkingRegisterConnectivityHintChanged 和 XNetworkingUnregisterConnectivityHintChanged 函数来侦听更改。

返回的 XNetworkingConnectivityHint 结构中的字段（XNetworkingConnectivityHint::networkInitialized 字段除外）是提示内容。 这些提示是设备根据设备上网络流量摘要对当前网络状态的最佳推测。 重要的是，这些字段并不表示是否存在到特定游戏终结点的连接。 我们建议在网络初始化后，无论 XNetworkingConnectivityHint::connectivityLevelHint 字段的状态如何，都使用 WinSock 和/或 WinHTTP 来尝试建立与终结点的连接。 如果这些 API 后来失败了，我们建议您将 XNetworkingGetConnectivityHint API 用于其他 UI 和诊断报告目的。 然后，您应等到网络连接级别发生变化之后，再重试。

有关网络初始化的详细信息，请参阅网络初始化和连接。

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

要求

头文件：XNetworking.h

库：xgameruntime.lib

支持平台：Windows、Xbox One 系列主机和 Xbox Series 主机

另请参阅

XNetworkingRegisterConnectivityHintChanged
XNetworkingUnregisterConnectivityHintChanged
检测网络初始化状态
XNetworking