XboxLiveEndpointPairTemplate Klasse

Definition

Namespace:

Windows.Networking.XboxLive

Stellt ein vorkonfiguriertes Muster dar, um eine optimale und sichere Kommunikation zwischen zwei Geräten mithilfe von Sockets zu ermöglichen. Die von dieser Klasse definierte Vorlage enthält Details dazu, wie zwei Endpunkte in einer XboxLiveEndpointPair verbunden sind. Vorlagen werden statisch im Netzwerkmanifest Ihrer App deklariert und anschließend mithilfe eindeutiger Namenszeichenfolgen identifiziert.

Hinweis

Vorlagen werden nur im Netzwerkmanifest der App deklariert. Sie können eine Vorlage zur Laufzeit nicht deklarieren oder ändern.

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 XboxLiveEndpointPairTemplate 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 XboxLiveEndpointPairTemplate 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 XboxLiveEndpointPairTemplate

Public NotInheritable Class XboxLiveEndpointPairTemplate

Vererbung

Object Platform::Object IInspectable XboxLiveEndpointPairTemplate

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

Ihr Code instanziieren diese Klasse nicht mithilfe eines Konstruktors. Stattdessen erstellen Sie eine instance einer bestimmten vordefinierten Vorlage, indem Sie die statische XboxLiveEndpointPairTemplate.GetTemplateByName-Methode mit dem Namen der gewünschten Vorlage aufrufen.

Eigenschaften

AcceptorBoundPortRangeLower	Ruft die untere Grenze des akzeptierten Portbereichs ab, wie im App-Netzwerkmanifest definiert. 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.
AcceptorBoundPortRangeUpper	Ruft die obere Grenze des akzeptierten Portbereichs ab, wie im App-Netzwerkmanifest definiert. 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.
EndpointPairs	Statische Eigenschaft, die eine Liste der aktuellen XboxLiveEndpointPair-Objekte abruft, die mit dieser Vorlage erstellt wurden. 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.
InitiatorBoundPortRangeLower	Ruft die untere Grenze des initiatorgebundenen Portbereichs ab, wie im App-Netzwerkmanifest definiert. 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.
InitiatorBoundPortRangeUpper	Ruft die Obergrenze des initiatorgebundenen Portbereichs ab, wie im App-Netzwerkmanifest definiert. 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.
Name	Ruft den Namen der Vorlage (deklariert im App-Netzwerkmanifest) ab, die zum Instanziieren dieses Objekts verwendet wurde. 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.
SocketKind	Ruft einen Wert ab, der die Art des Sockets angibt, der von dieser Vorlage deklariert 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.
Templates	Statische Eigenschaft, die alle von der App deklarierten Vorlagen auflistet. Vorlagen werden zur Buildzeit im Netzwerkmanifest der App deklariert und können zur Laufzeit nicht deklariert oder geändert werden. 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

CreateEndpointPairAsync(XboxLiveDeviceAddress)	Erstellt basierend auf der aktuellen Vorlage eine XboxLiveEndpointPair zwischen dem lokalen Gerät und einem angegebenen Remotegerät mit dem Erstellungsverhalten XboxLiveEndpointPairCreationBehaviors.None. 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.
CreateEndpointPairAsync(XboxLiveDeviceAddress, XboxLiveEndpointPairCreationBehaviors)	Erstellt eine XboxLiveEndpointPair zwischen dem lokalen Gerät und einem angegebenen Remotegerät und gibt dabei an, wie sich das System verhalten soll, wenn für diese Vorlage und das Remotegerät bereits ein XboxLiveEndpointPair vorhanden 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.
CreateEndpointPairForPortsAsync(XboxLiveDeviceAddress, String, String)	Erstellt ein Endpunktpaar zwischen dem lokalen Gerät und dem angegebenen Remotegerät, wobei bestimmte Ports aus dem angegebenen Bereich zulässiger Ports der Vorlage mit dem Erstellungsverhalten XboxLiveEndpointPairCreationBehaviors.None angegeben werden. 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.
CreateEndpointPairForPortsAsync(XboxLiveDeviceAddress, String, String, XboxLiveEndpointPairCreationBehaviors)	Erstellt ein Endpunktpaar zwischen dem lokalen Gerät und dem angegebenen Remotegerät, wobei bestimmte Ports aus den von der Vorlage festgelegten Bereichen akzeptabler Ports angegeben und angegeben werden, wie sich das System verhalten soll, wenn für diese Vorlage, das Remotegerät und die Portkombination bereits eine XboxLiveEndpointPair vorhanden 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.
GetTemplateByName(String)	Statische Methode, die eine XboxLiveEndpointPairTemplate für die benannte Vorlage erstellt. Vorlagen werden im App-Netzwerkmanifest definiert. Jede Vorlage im Manifest muss einen eindeutigen Namen erhalten haben. 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

InboundEndpointPairCreated

Das Ereignis wird ausgelöst, wenn ein Remotegerät erfolgreich ein Endpunktpaar von sich selbst zum lokalen Computer erstellt. Details zum neuen Endpunktpaar finden Sie in den Ereignisargumenten. 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.