XNetworkingConnectivityHint
ネットワーク接続レベル、データ制限、インターフェイスの種類、ネットワーク初期化状態など、ネットワークの現在のデバイス全体の状態を定義します。構文
メンバー
connectivityLevelType: XNetworkingConnectivityLevelHint デバイスの現在のベスト エフォート接続レベル。 connectivityCost
Type: XNetworkingConnectivityCostHint デバイスのデータ制限の現在のベスト エフォート分類。 ianaInterfaceType
Type: uint32_t インターネットに到達するために WinSock および WinHTTP で使用される可能性が高い現在のインターフェイスの種類。IANA NDIS Interface Types のいずれか。 networkInitialized
Type: bool ネットワークが現在初期化されているかどうかを判定します。詳細については、ネットワーク情報の取得 の ネットワークの初期化 セクションを参照してください。 approachingDataLimit
Type: bool デバイスがデータ制限の超過に近づいているかどうかを判定します。 overDataLimit
Type: bool デバイスがデータ制限を超えているかどうかを判定します。 roaming
Type: bool デバイスがローミング中かどうかを判定します。
解説
ネットワーキングまたはセキュリティ API を使用する前に、networkInitialized メンバーが true を返すことを確認してください。初期化されていないネットワークで XNetworking API を使用しようとすると、呼び出しが失敗し、予測不可能な動作が発生します。
XNetworkingConnectivityHint 構造体のフィールド (XNetworkingConnectivityHint::networkInitialized フィールドを除く) はヒントです。これらは、デバイス上のネットワーク トラフィックの要約に基づいて、ネットワークの現在の状態についてデバイスが行うベスト エフォートの推測です。重要な点として、これらのフィールドは、特定のタイトル エンドポイントへの接続があるかどうかを表すものではありません。ネットワークの初期化を待った後、XNetworkingConnectivityHint::connectivityLevelHint フィールドの状態にかかわらず、WinSock または WinHTTP (あるいはその両方) を使用してエンドポイントへの接続を試みることをお勧めします。それらの API がその後失敗した場合は、XNetworkingGetConnectivityHint API を使用して、追加の UI や診断報告の目的で利用することをお勧めします。その後、ネットワーク接続レベルが変化するのを待ってから、再試行してください。