> ## 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` フィールドを除く) はヒントです。これらは、デバイス上のネットワーク トラフィックの概要に基づく、ネットワークの現在の状態についてのデバイスによるベスト エフォートの推測です。重要な点として、これらのフィールドは特定のタイトル エンドポイントへの接続があるかどうかを表しません。ネットワーク初期化を待った後、`XNetworkingConnectivityHint::connectivityLevelHint` フィールドの状態に関係なく、WinSock や WinHTTP を使用してエンドポイントへの接続の確立を試みることをお勧めします。それらの API が失敗した場合は、追加の UI と診断レポートを目的として `XNetworkingGetConnectivityHint` API を使用することをお勧めします。その後、再試行する前にネットワーク接続レベルの変化を待つ必要があります。

ネットワークの初期化の詳細については、「[ネットワークの初期化と接続](/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](/ja-jp/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged.md)
- [XNetworkingConnectivityHintChangedCallback](/ja-jp/reference/networking/xnetworking/functions/xnetworkingconnectivityhintchangedcallback.md)
- [XNetworkingUnregisterConnectivityHintChanged](/ja-jp/reference/networking/xnetworking/functions/xnetworkingunregisterconnectivityhintchanged.md)
- [XNetworkingConnectivityHint](/ja-jp/reference/networking/xnetworking/structs/xnetworkingconnectivityhint.md)
- [ネットワーク初期化状態の検出](/ja-jp/build/console-features/networking/initialization-connectivity-networking.md)