> ## 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](/zh-TW/reference/networking/xnetworking/enums/xnetworkingconnectivitylevelhint)

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

*connectivityCost*<br />類型：[XNetworkingConnectivityCostHint](/zh-TW/reference/networking/xnetworking/enums/xnetworkingconnectivitycosthint)

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

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

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

*networkInitialized*<br />類型：bool

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

*approachingDataLimit*<br />類型：bool

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

*overDataLimit*<br />類型：bool

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

*roaming*<br />類型：bool

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

## 備註

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

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

此結構由 [XNetworkingGetConnectivityHint](/zh-TW/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint) API 以及註冊流程的回呼傳回。如需 Microsoft Game Development Kit (GDK) 遊戲中的網路資訊，請參閱[擷取網路資訊](/zh-TW/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](/zh-TW/reference/networking/xnetworking/xnetworking_members)


## Related topics

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