XboxLiveDeviceAddress Klasse

Definition

Namespace:

Windows.Networking.XboxLive

Stellt den Netzwerkspeicherort einer Konsole oder eines anderen authentifizierten Geräts dar.

Objekte dieser Klasse stellen eine undurchsichtige Sammlung von Konnektivitätsinformationen zu einem Gerät dar (insbesondere eine Liste von IP-Adressen). Sie übergeben eine XboxLiveDeviceAddress an eine der CreateEndpointPairTemplate-Methoden der XboxLiveEndpointPairAsync- oder CreateEndpointPairForPortsAsync-Methode der XboxLiveEndpoint-Klasse, um eine XboxLiveEndpointPair zwischen dem lokalen Gerät und dem Gerät an der angegebenen XboxLiveDeviceAddress zu instanziieren.

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

Public NotInheritable Class XboxLiveDeviceAddress

Vererbung

Object Platform::Object IInspectable XboxLiveDeviceAddress

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)

Eigenschaften

IsLocal	Ruft einen booleschen Wert ab, der angibt, ob diese XboxLiveDeviceAddress das lokale Gerät 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.
IsValid	Ruft einen booleschen Wert ab, der angibt, ob diese XboxLiveDeviceAddress gültig 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.
MaxSnapshotBytesSize	Ruft einen Wert ab, der die maximale Anzahl von Bytes angibt, die für das Array von Bytes erforderlich sind, die an XboxLiveDeviceAddress.GetSnapshotAsBytes übergeben 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.
NetworkAccessKind	Ruft einen Wert ab, der die Ebene des Peer-to-Peer-Netzwerkzugriffs beschreibt, der für die XboxLiveEndpointPair-Kommunikation mit dieser XboxLiveDeviceAddress beobachtet wird. Der angegebene Zugriff gilt nur für die Kommunikation, die über die Xbox Live Multiplayer-Netzwerk-API-Infrastruktur eingerichtet wurde. Wenn Sie Ihre eigene unsichere Kommunikation einrichten oder Einen eigenen NAT-Durchlauf implementieren, stellen Sie möglicherweise fest, dass dieser Code auf eine andere Zugriffsart stößt. 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

Compare(XboxLiveDeviceAddress)	Vergleicht ein anderes XboxLiveDeviceAddress-Objekt mit dem aktuellen Objekt, um festzustellen, ob es dasselbe Gerät 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.
CreateFromSnapshotBase64(String)	Erstellt ein XboxLiveDeviceAddress-Objekt aus einer Momentaufnahme, die in der Base64-Codierung gespeichert ist. Verwenden Sie diese Methode, um eine XboxLiveDeviceAddress aus dem Base64-codierten Momentaufnahme zu erstellen, der von einem früheren Aufruf von XboxLiveDeviceAddress.GetSnapshotAsBase64 zurückgegeben 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.
CreateFromSnapshotBuffer(IBuffer)	Erstellt ein XboxLiveDeviceAddress-Objekt aus einer Momentaufnahme, die in einem Puffer gespeichert ist. Verwenden Sie diese Methode, um eine XboxLiveDeviceAddress aus dem Momentaufnahme Puffer zu erstellen, der von einem früheren Aufruf von XboxLiveDeviceAddress.GetSnapshotAsBuffer zurückgegeben 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.
CreateFromSnapshotBytes(Byte[])	Erstellt eine XboxLiveDeviceAddress aus einer Momentaufnahme, die als Array von Bytes gespeichert ist. Verwenden Sie diese Methode, um ein XboxLiveDeviceAddress-Objekt aus einem gespeicherten Momentaufnahme mit der XboxLiveDeviceAddress.GetSnapshotAsBytes-Methode abgerufen zu erstellen. 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.
GetLocal()	Erstellt eine XboxLiveDeviceAddress für das lokale Gerät. 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.
GetSnapshotAsBase64()	Ruft eine Momentaufnahme der aktuellen XboxLiveDeviceAddress als Base64-codierte Zeichenfolge ab. Sie können diese Momentaufnahme speichern, um später als base64-Parameter in einem Aufruf von XboxLiveDeviceAddress.CreateFromSnapshotBase64 zu verwenden. 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.
GetSnapshotAsBuffer()	Ruft eine Momentaufnahme der aktuellen XboxLiveDeviceAddress ab und gibt sie als Objekt zurück, das IBuffer implementiert. Sie können diese Methode verwenden, um eine Momentaufnahme für die spätere Verwendung mit der XboxLiveDeviceAddress.CreateFromSnapshotBuffer-Methode zu speichern. 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.
GetSnapshotAsBytes(Byte[], UInt32)	Speichert eine XboxLiveDeviceAddress in einem Bytearray. Sie können diese Methode verwenden, um eine Momentaufnahme für die Verwendung mit der XboxLiveDeviceAddress.CreateFromSnapshotBytes-Methode zu speichern. 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

SnapshotChanged

Ereignis ausgelöst, wenn sich die Momentaufnahme für diese XboxLiveDeviceAddress geändert hat. Momentaufnahmen sind serialisierte Formen von XboxLiveDeviceAddress-Objekten , die über Out-of-Band-Kanäle wie Xbox Live Matchmaking an Remotegeräte übertragen werden können. Sie stellen jedoch die Netzwerkadresseninformationen eines Geräts zu einem bestimmten Zeitpunkt dar, und sie können sich im Laufe der Zeit ändern. Um unnötige Konnektivitätsprobleme zu vermeiden, sollten Sie auf XboxLiveDeviceAddress.SnapshotChanged-Ereignisse auf der lokalen Geräteadresse lauschen, um zu wissen, wann die Momentaufnahme Inhalte aktualisiert wurden, und aktualisieren Sie die serialisierte Momentaufnahme überall dort, wo Sie sie übertragen oder zwischengespeichert haben, damit Remotegeräte immer über die neuesten Informationen verfügen. 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.