次の方法で共有

XboxLiveEndpointPair クラス

  • リファレンス

定義

名前空間:
Windows.Networking.XboxLive
編集

XboxLiveEndpointPair は、ソケットベースの通信のために 2 つのデバイス間で確立されたセキュリティとネットワーク品質の関係です。

Windows.Networking.XboxLive API を使用すると、さまざまな環境でのピアツーピア (P2P) 接続が可能になり、IPv4、IPv6、および Microsoft のネットワーク アドレス変換 (NAT) トラバーサル テクノロジとサービス (Teredo など) を利用して、エンドポイント間で使用可能な最適なネットワーク パスを決定および構成できます。 また、不正行為を減らす手段として、トラフィックの暗号化と改ざんに対する保護を確立します。 さらに、dmash&Xbox Live エコシステムを通じてユーザーとアプリケーションを認証します。接続情報を他の Xbox Live サービスと統合する。 その後、この情報をマッチメーキングで使用して、類似の接続統計を持つプレイヤーを互いに照合することができます。

Windows.Networking.XboxLive API は、TCP や UDP などの従来のネットワーク トランスポートと、使用可能なソケット API、WinSock、Windows.Networking.Sockets を補完し、拡張します。 この API を使用して XboxLiveEndpointPair を作成し、実際のデータ転送に優先トランスポート API を使用します。 XboxLiveEndpointPair の概念自体は、ローカルおよびリモートの IP アドレスとポートのセットとして解釈できる点で、Windows.Networking.EndpointPair に関連しています。ただし、XboxLiveEndpointPair では、これらのプロパティは読み取り専用であり (システムがネゴシエートするため)、有効期間が関連付けられています (XboxLiveEndpointPair は、さまざまな理由で終了できるアクティブなセキュリティ関係を表しているため)。

重要

この API は、すべてのアプリで使用できるわけではありません。 開発者アカウントが Microsoft によって特別にプロビジョニングされていない限り、これらの API の呼び出しは実行時に失敗します。

public ref class XboxLiveEndpointPair sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Networking.XboxLive.XboxLiveSecureSocketsContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class XboxLiveEndpointPair final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Networking.XboxLive.XboxLiveSecureSocketsContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class XboxLiveEndpointPair
Public NotInheritable Class XboxLiveEndpointPair
継承
Object Platform::Object IInspectable XboxLiveEndpointPair
属性
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows の要件

デバイス ファミリ
Xbox One System Apps Extensions for the UWP (10.0.0.1 で導入)
 Xbox Live Extension SDK (10.0.10240.0 で導入)
 Xbox One Extensions for the UWP (10.0.10240.0 で導入)
 Windows Desktop Extension SDK (10.0.16299.0 で導入)
API contract
Windows.Networking.XboxLive.XboxLiveSecureSocketsContract (v1.0 で導入)

注釈

コンストラクターを使用してこのクラスのインスタンスを作成することはありません。 代わりに、XboxLiveEndpointPairTemplate クラスの CreateEndpointPairAsync メソッドまたは CreateEndpointPairForPorts メソッドのいずれかを使用して、特定の通信テンプレートに続くエンドポイント ペアを作成します。

プロパティ

LocalHostName

重要

この API は、すべてのアプリで使用できるわけではありません。 開発者アカウントが Microsoft によって特別にプロビジョニングされていない限り、これらの API の呼び出しは実行時に失敗します。
LocalPort

ローカル エンドポイントのポートを取得します。

重要

この API は、すべてのアプリで使用できるわけではありません。 開発者アカウントが Microsoft によって特別にプロビジョニングされていない限り、これらの API の呼び出しは実行時に失敗します。
RemoteDeviceAddress

リモート エンドポイントの XboxLiveDeviceAddress を取得します。

重要

この API は、すべてのアプリで使用できるわけではありません。 開発者アカウントが Microsoft によって特別にプロビジョニングされていない限り、これらの API の呼び出しは実行時に失敗します。
RemoteHostName

リモート エンドポイントの HostName を取得します。

重要

この API は、すべてのアプリで使用できるわけではありません。 開発者アカウントが Microsoft によって特別にプロビジョニングされていない限り、これらの API の呼び出しは実行時に失敗します。
RemotePort

リモート エンドポイントのポートを取得します。

重要

この API は、すべてのアプリで使用できるわけではありません。 開発者アカウントが Microsoft によって特別にプロビジョニングされていない限り、これらの API の呼び出しは実行時に失敗します。
State

この XboxLiveEndpointPair の状態を表す値を取得します。

重要

この API は、すべてのアプリで使用できるわけではありません。 開発者アカウントが Microsoft によって特別にプロビジョニングされていない限り、これらの API の呼び出しは実行時に失敗します。
Template

このエンドポイント ペアのインスタンス化に使用される XboxLiveEndpointPairTemplate を取得します。

重要

この API は、すべてのアプリで使用できるわけではありません。 開発者アカウントが Microsoft によって特別にプロビジョニングされていない限り、これらの API の呼び出しは実行時に失敗します。

メソッド

DeleteAsync()

2 つのエンドポイント間の XboxLiveEndpointPair セキュリティ関係を正常に終了します。 リモート デバイスを通知するためのベスト エフォート試行が実行されますが、リモート デバイスが使用できなくなったり到達可能になったりした場合に、この通知が受信される保証はありません。 代わりに、リモート デバイスが XboxLiveEndpointPair をタイムアウトすることがあります。 リモート デバイスまたは XboxLiveEndpointPair の以前の状態に関係なく、アクションは正常に完了します。

重要

この API は、すべてのアプリで使用できるわけではありません。 開発者アカウントが Microsoft によって特別にプロビジョニングされていない限り、これらの API の呼び出しは実行時に失敗します。
FindEndpointPairByHostNamesAndPorts(HostName, String, HostName, String)

既存の XboxLiveEndpointPair インスタンスが存在する場合は、最初のホストとポートから 2 つ目のホストとポートへのトラフィックに関連付けられているインスタンスを検索します。

この方法を使用して、受信トラフィックから、そのトラフィックに関連付けられている XboxLiveEndpointPair に逆方向に動作します。

重要

この API は、すべてのアプリで使用できるわけではありません。 開発者アカウントが Microsoft によって特別にプロビジョニングされていない限り、これらの API の呼び出しは実行時に失敗します。
FindEndpointPairBySocketAddressBytes(Byte[], Byte[])

2 つの特定のソケット アドレス間のトラフィックに関連付けられている既存の XboxLiveEndpointPair インスタンス (存在する場合) を検索します。ソケット アドレスは、Winsock SOCKADDR_STORAGE または関連する構造体を含む Byte の配列として提供されます。

この方法を使用して、受信トラフィックから、そのトラフィックに関連付けられている XboxLiveEndpointPair に逆方向に動作します。

重要

この API は、すべてのアプリで使用できるわけではありません。 開発者アカウントが Microsoft によって特別にプロビジョニングされていない限り、これらの API の呼び出しは実行時に失敗します。
GetLocalSocketAddressBytes(Byte[])

ローカル エンドポイントのソケット アドレス情報を Byte の配列として取得します。 このメソッドは、Xbox Live マルチプレイヤー ネットワーク API を利用する後続の Winsock 操作で使用するために、指定されたバイト バッファーにローカル デバイスの SOCKADDR_STORAGE アドレスを入力します。

重要

この API は、すべてのアプリで使用できるわけではありません。 開発者アカウントが Microsoft によって特別にプロビジョニングされていない限り、これらの API の呼び出しは実行時に失敗します。
GetRemoteSocketAddressBytes(Byte[])

リモート エンドポイントのソケット アドレス情報を Byte の配列として取得します。 このメソッドは、Xbox Live マルチプレイヤー ネットワーク API を利用する後続の Winsock 操作で使用するために、指定されたバイト バッファーにリモート デバイスの SOCKADDR_STORAGE アドレスを入力します。

重要

この API は、すべてのアプリで使用できるわけではありません。 開発者アカウントが Microsoft によって特別にプロビジョニングされていない限り、これらの API の呼び出しは実行時に失敗します。

イベント

StateChanged

XboxLiveEndpointPair の状態が変更されたときに発生するイベント。

重要

この API は、すべてのアプリで使用できるわけではありません。 開発者アカウントが Microsoft によって特別にプロビジョニングされていない限り、これらの API の呼び出しは実行時に失敗します。

適用対象