XNetworkingConnectivityHint
定義目前整個裝置的網路狀態，包括網路連線層級、數據限制、介面類型和網路初始化狀態。語法
成員
connectivityLevel類型：XNetworkingConnectivityLevelHint 裝置目前盡力判斷的連線層級。 connectivityCost
類型：XNetworkingConnectivityCostHint 裝置目前盡力判斷的數據限制分類。 ianaInterfaceType
類型：uint32_t WinSock 和 WinHTTP 目前可能用來連線至網際網路的介面類型。為其中一種 IANA NDIS 介面類型。 networkInitialized
類型：bool 判斷網路目前是否已初始化。如需詳細資訊，請參閱擷取網路資訊中的網路初始化一節。 approachingDataLimit
類型：bool 判斷裝置是否即將超過其數據限制。 overDataLimit
類型：bool 判斷裝置是否已超過其數據限制。 roaming
類型：bool 判斷裝置是否處於漫遊狀態。
備註
在嘗試使用任何網路或安全性 API 之前，請確定 networkInitialized 成員傳回 true。在未初始化的網路上嘗試使用 XNetworking API，會導致呼叫失敗並產生無法預期的行為。
XNetworkingConnectivityHint 結構中的欄位 (XNetworkingConnectivityHint::networkInitialized 欄位除外) 都是提示。這些是裝置根據裝置上網路流量的摘要，對目前網路狀態所做的盡力推測。重要的是，這些欄位並不代表是否能連線到您遊戲的特定端點。我們建議在等待網路初始化之後，無論 XNetworkingConnectivityHint::connectivityLevelHint 欄位的狀態為何，都使用 WinSock 和/或 WinHTTP 嘗試與您的端點建立連線。如果這些 API 隨後失敗，我們建議您接著使用 XNetworkingGetConnectivityHint API 進行額外的 UI 和診斷報告。然後，您應該等待網路連線層級變更後再重試。