> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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*\
類型：[XNetworkingConnectivityLevelHint](https://docs.xbox.com/zh-TW/reference/networking/xnetworking/enums/xnetworkingconnectivitylevelhint.md)

裝置目前盡力判斷的連線層級。

*connectivityCost*\
類型：[XNetworkingConnectivityCostHint](https://docs.xbox.com/zh-TW/reference/networking/xnetworking/enums/xnetworkingconnectivitycosthint.md)

裝置目前盡力判斷的數據限制分類。

*ianaInterfaceType*\
類型：uint32\_t

WinSock 和 WinHTTP 目前可能用來連線至網際網路的介面類型。為其中一種 [IANA NDIS 介面類型](https://learn.microsoft.com/windows-hardware/drivers/network/ndis-interface-types)。

*networkInitialized*\
類型：bool

判斷網路目前是否已初始化。如需詳細資訊，請參閱[擷取網路資訊](https://docs.xbox.com/zh-TW/build/console-features/networking/initialization-connectivity-networking.md)中的[網路初始化](https://docs.xbox.com/zh-TW/build/console-features/networking/initialization-connectivity-networking.md)一節。

*approachingDataLimit*\
類型：bool

判斷裝置是否即將超過其數據限制。

*overDataLimit*\
類型：bool

判斷裝置是否已超過其數據限制。

*roaming*\
類型：bool

判斷裝置是否處於漫遊狀態。

## 備註

在嘗試使用任何網路或安全性 API 之前，請確定 *networkInitialized* 成員傳回 true。

> [!NOTE]
>
> 在未初始化的網路上嘗試使用 XNetworking API，會導致呼叫失敗並產生無法預期的行為。

此結構由 [XNetworkingGetConnectivityHint](https://docs.xbox.com/zh-TW/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint.md) API 以及註冊流程的回呼傳回。如需 Microsoft Game Development Kit (GDK) 遊戲中的網路資訊，請參閱[擷取網路資訊](https://docs.xbox.com/zh-TW/build/console-features/networking/initialization-connectivity-networking.md)。

傳回的 `XNetworkingConnectivityHint` 結構中的欄位 (`XNetworkingConnectivityHint::networkInitialized` 欄位除外) 都是提示。這些是裝置根據裝置上網路流量的摘要，對目前網路狀態所做的盡力推測。重要的是，這些欄位並不代表是否能連線到您遊戲的特定端點。我們建議在等待網路初始化之後，無論 `XNetworkingConnectivityHint::connectivityLevelHint` 欄位的狀態為何，都使用 WinSock 和/或 WinHTTP 嘗試與您的端點建立連線。如果這些 API 隨後失敗，我們建議您接著使用 `XNetworkingGetConnectivityHint` API 進行額外的 UI 和診斷報告。然後，您應該等待網路連線層級變更後再重試。

## 需求

**標頭：** XNetworking.h

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[XNetworking](https://docs.xbox.com/zh-TW/reference/networking/xnetworking/xnetworking_members.md)


## Related topics

- [XNetworkingConnectivityHintChangedCallback](https://docs.xbox.com/zh-TW/reference/networking/xnetworking/functions/xnetworkingconnectivityhintchangedcallback.md)
- [XNetworkingGetConnectivityHint](https://docs.xbox.com/zh-TW/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint.md)
- [XNetworkingConnectivityCostHint](https://docs.xbox.com/zh-TW/reference/networking/xnetworking/enums/xnetworkingconnectivitycosthint.md)
- [XNetworkingConnectivityLevelHint](https://docs.xbox.com/zh-TW/reference/networking/xnetworking/enums/xnetworkingconnectivitylevelhint.md)
- [XNetworkingRegisterConnectivityHintChanged](https://docs.xbox.com/zh-TW/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged.md)