> ## 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.

# XNetworkingRegisterConnectivityHintChanged

> XNetworkingRegisterConnectivityHintChanged

# XNetworkingRegisterConnectivityHintChanged

現在のネットワーク接続レベル、データ制限、インターフェイスの種類、およびネットワーク初期化状態に関するデバイス全体の情報の変更に、タイトルを登録します。

## 構文

```cpp theme={null}
HRESULT XNetworkingRegisterConnectivityHintChanged(
         XTaskQueueHandle queue,
         void* context,
         XNetworkingConnectivityHintChangedCallback* callback,
         XTaskQueueRegistrationToken* token
)
```

### パラメーター

*queue*   \_In\_opt\_\
型: XTaskQueueHandle

接続ヒントが変更されたときにコールバックを配置するキュー。

*context*   \_In\_opt\_\
型: void\*

コールバックに渡すオプションのコンテキスト ポインター。

*callback*   \_In\_\
型: XNetworkingConnectivityHintChangedCallback\*

接続ヒントが変更されたときに呼び出す関数。

*token*   \_Out\_\
型: [XTaskQueueRegistrationToken](/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken)\*

登録解除時にコールバックを識別するために使用されるトークン。

### 戻り値

型: HRESULT

HRESULT の成功またはエラー コード。

## 解説

この関数は "接続ヒント変更" 通知を登録し、初期通知コールバックを送信します。

コールバックの登録を解除するには、[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 コンソール

## 関連項目

[XNetworkingGetConnectivityHint](/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint)\
[XNetworkingUnregisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingunregisterconnectivityhintchanged)\
[XNetworking](/reference/networking/xnetworking/xnetworking_members)


## Related topics

- [XNetworkingConnectivityHintChangedCallback](/ja-jp/reference/networking/xnetworking/functions/xnetworkingconnectivityhintchangedcallback.md)
- [XNetworkingUnregisterConnectivityHintChanged](/ja-jp/reference/networking/xnetworking/functions/xnetworkingunregisterconnectivityhintchanged.md)
- [XNetworkingGetConnectivityHint](/ja-jp/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint.md)
- [ネットワーク初期化状態の検出](/ja-jp/build/console-features/networking/initialization-connectivity-networking.md)
- [XTaskQueueRegistrationToken](/ja-jp/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken.md)