XboxLiveEndpointPair Klasse

Definition

Namespace:

Windows.Networking.XboxLive

Ein XboxLiveEndpointPair ist eine Sicherheits- und Netzwerkqualitätsbeziehung zwischen zwei Geräten für die socketbasierte Kommunikation.

Die Windows.Networking.XboxLive-API ermöglicht Peer-to-Peer-Konnektivität (P2P) in verschiedenen Umgebungen und nutzt dabei IPv4- und IPv6- und NAT-Durchlauftechnologien und -dienste (z. B. Teredo) von Microsoft, um den besten verfügbaren Netzwerkpfad zwischen Endpunkten zu ermitteln und zu konfigurieren. Außerdem wird die Verschlüsselung des Datenverkehrs und der Schutz vor Manipulationen als Maßnahme zur Verringerung von Betrug eingeführt. Darüber hinaus werden Benutzer und Anwendungen über das Xbox Live-Ökosystem&dmash authentifiziert. Integration von Konnektivitätsinformationen in andere Xbox Live-Dienste. Diese Informationen können dann beim Matchmaking verwendet werden, um spieler mit ähnlichen Konnektivitätsstatistiken gegeneinander abzugleichen.

Die Windows.Networking.XboxLive-API ergänzt und erweitert herkömmliche Netzwerktransporte wie TCP und UDP sowie die verfügbaren Sockets-APIs, WinSock und Windows.Networking.Sockets. Sie erstellen eine XboxLiveEndpointPair-Instanz mit dieser API und verwenden dann Ihre bevorzugte Transport-API für die tatsächliche Datenübertragung. Das XboxLiveEndpointPair-Konzept selbst bezieht sich auf Windows.Networking.EndpointPair , da es als eine Reihe von lokalen und Remote-IP-Adressen und Ports interpretiert werden kann; Bei einem XboxLiveEndpointPair sind diese Eigenschaften jedoch schreibgeschützt (da das System sie aushandelt) und haben eine zugeordnete Gültigkeitsdauer (da xboxLiveEndpointPair eine aktive Sicherheitsbeziehung darstellt, die aus verschiedenen Gründen beendet werden kann).

Wichtig

Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.

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

Vererbung

Object Platform::Object IInspectable XboxLiveEndpointPair

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Xbox One System Apps Extensions for the UWP (eingeführt in 10.0.0.1) Xbox Live Extension SDK (eingeführt in 10.0.10240.0) Xbox One Extensions for the UWP (eingeführt in 10.0.10240.0) Windows Desktop Extension SDK (eingeführt in 10.0.16299.0)
API contract	Windows.Networking.XboxLive.XboxLiveSecureSocketsContract (eingeführt in v1.0)

Hinweise

Sie erstellen keine Instanzen dieser Klasse mithilfe eines Konstruktors. Stattdessen verwenden Sie eine der Methoden CreateEndpointPairAsync oder CreateEndpointPairForPorts in der XboxLiveEndpointPairTemplate-Klasse , um ein Endpunktpaar zu erstellen, das einer bestimmten Kommunikationsvorlage folgt.

Eigenschaften

LocalHostName	Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.
LocalPort	Ruft den Port für den lokalen Endpunkt ab. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.
RemoteDeviceAddress	Ruft die XboxLiveDeviceAddress für den Remoteendpunkt ab. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.
RemoteHostName	Ruft einen HostName für den Remoteendpunkt ab. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.
RemotePort	Ruft den Port für den Remoteendpunkt ab. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.
State	Ruft einen Wert ab, der den Zustand dieses XboxLiveEndpointPair darstellt. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.
Template	Ruft die XboxLiveEndpointPairTemplate ab, die zum Instanziieren dieses Endpunktpaars verwendet wird. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.

Methoden

DeleteAsync()	Beginnt mit dem ordnungsgemäßen Beenden der XboxLiveEndpointPair-Sicherheitsbeziehung zwischen den beiden Endpunkten. Es wird versucht, das Remotegerät nach besten Kräften zu benachrichtigen, obwohl es keine Garantie dafür gibt, dass diese Benachrichtigung empfangen wird, wenn das Remotegerät nicht mehr verfügbar oder erreichbar ist. Das Remotegerät kann stattdessen ein Timeout für XboxLiveEndpointPair ausführen. Die Aktion wird unabhängig vom Remotegerät oder der vorherigen status des XboxLiveEndpointPair erfolgreich abgeschlossen. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.
FindEndpointPairByHostNamesAndPorts(HostName, String, HostName, String)	Sucht nach einem vorhandenen XboxLiveEndpointPair-instance, sofern vorhanden, dem Datenverkehr von einem ersten Host und Port zu einem zweiten Host und Port zugeordnet ist. Verwenden Sie diese Methode, um rückwärts vom eingehenden Datenverkehr an die XboxLiveEndpointPair zu arbeiten, die diesem Datenverkehr zugeordnet ist. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.
FindEndpointPairBySocketAddressBytes(Byte[], Byte[])	Sucht nach einem vorhandenen XboxLiveEndpointPair-instance, sofern vorhanden, dem Datenverkehr zwischen zwei angegebenen Socketadressen zugeordnet ist, wobei die Socketadressen als Bytearrays bereitgestellt werden, die Winsock-SOCKADDR_STORAGE oder verwandte Strukturen enthalten. Verwenden Sie diese Methode, um rückwärts vom eingehenden Datenverkehr an den XboxLiveEndpointPair zu arbeiten, der diesem Datenverkehr zugeordnet ist. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.
GetLocalSocketAddressBytes(Byte[])	Ruft die Socketadresseninformationen des lokalen Endpunkts als Bytearray ab. Diese Methode füllt den angegebenen Bytepuffer mit der SOCKADDR_STORAGE Adresse des lokalen Geräts zur Verwendung in nachfolgenden Winsock-Vorgängen unter Verwendung der Xbox Live Multiplayer Networking-API. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.
GetRemoteSocketAddressBytes(Byte[])	Ruft die Socketadresseninformationen des Remoteendpunkts als Bytearray ab. Diese Methode füllt den angegebenen Bytepuffer mit der SOCKADDR_STORAGE Adresse des Remotegeräts zur Verwendung in nachfolgenden Winsock-Vorgängen unter Verwendung der Xbox Live Multiplayer Networking-API. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.

Ereignisse

StateChanged

Das Ereignis wird ausgelöst, wenn sich der Status von XboxLiveEndpointPair ändert. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.