Skip to main content

XNetworkingUnregisterConnectivityHintChanged

XNetworkingRegisterConnectivityHintChanged で登録されたコールバック関数の登録を解除します。

構文

パラメーター

token   _In_
Type: XTaskQueueRegistrationToken
XNetworkingRegisterConnectivityHintChanged から返されたトークン。 wait   _In_
Type: bool
保留中のコールバックが完了するまでブロックするかどうかを示します。

戻り値

Type: bool wait が false で登録解除の呼び出しが保留中の場合は false を返します。それ以外の場合は true を返します。

解説

この関数は、時間的制約のあるスレッドで呼び出すことは安全ではありません。詳細については、時間的制約のあるスレッド を参照してください。
この関数は次のアクションを実行します。
  • トークンに関連付けられたコールバックが、登録されているコールバックのセットから削除されます。
  • そのコールバック トークンに対して実行中のコールバックがない場合、呼び出しは true を返します。
  • コールバックが実行中で wait が true の場合、実行中のコールバックが終了するまで呼び出しはブロックされます。
  • コールバックが実行中で wait が false の場合、呼び出しはブロックされませんが false を返します。トークンのコールバックが完了すると、トークンは自動的に登録解除されます。
この関数は、デッドロックが発生するため、wait が true の場合は XNetworkingConnectivityHintChangedCallback 内から呼び出さないでください。
このメカニズムにより、次のコーディング パターンが可能になります。
  • 登録解除呼び出しでブロックすることで、登録解除呼び出し後にコールバックが呼び出されないことを保証できます。
  • ブロックしないことを選択することもできます。データを削除する前にコールバックが完了することを保証する必要がある場合は、wait を false に設定して、この関数を定期的に呼び出すことができます。最終的に true が返されると、すべてのコールバックが完了しており、状態を削除できます。
  • コールバックが登録解除呼び出し中に呼び出されるかどうかを気にしない場合は、wait に false を渡して戻り値を無視できます。

要件

ヘッダー: XNetworking.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリ本体および XBOX Series 本体

概念ドキュメント

関連項目

XNetworkingRegisterConnectivityHintChanged
XNetworkingGetConnectivityHint
ネットワークの初期化と接続
XNetworking
最終更新日 2026年8月24日