XboxLiveEndpointPair Clase

Definición

Espacio de nombres:

Windows.Networking.XboxLive

XboxLiveEndpointPair es una relación de seguridad y calidad de red establecida entre dos dispositivos para la comunicación basada en sockets.

La API Windows.Networking.XboxLive permite la conectividad punto a punto (P2P) en entornos variados, aprovechando las tecnologías y servicios de traducción de direcciones de red (NAT) de IPv4, IPv6 y Microsoft (como Teredo) para determinar y configurar la mejor ruta de acceso de red disponible entre los puntos de conexión. También establece el cifrado del tráfico y la protección contra la manipulación, como medida para reducir la trampa. Además, autentica a los usuarios y aplicaciones a través del ecosistema de Xbox Live&dmash; integrar la información de conectividad con otros servicios de Xbox Live. A continuación, esta información se puede usar en la creación de coincidencias, para intentar buscar coincidencias con jugadores con estadísticas de conectividad similares entre sí.

La API Windows.Networking.XboxLive complementa y amplía los transportes de red tradicionales, como TCP y UDP, y las API de sockets disponibles, WinSock y Windows.Networking.Sockets. Creas un XboxLiveEndpointPair con esta API y, a continuación, usas tu API de transporte preferida para la transmisión de datos real. El propio concepto xboxLiveEndpointPair está relacionado con Windows.Networking.EndpointPair en que se puede interpretar como un conjunto de direcciones IP y puertos locales y remotos; pero con xboxLiveEndpointPair, esas propiedades son de solo lectura (porque el sistema las negocia) y tienen una vigencia de validez asociada (porque xboxLiveEndpointPair representa una relación de seguridad activa que se puede terminar por varias razones).

Importante

Esta API no está disponible para todas las aplicaciones. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.

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

Herencia

Object Platform::Object IInspectable XboxLiveEndpointPair

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Xbox One System Apps Extensions for the UWP (se introdujo en la versión 10.0.0.1) Xbox Live Extension SDK (se introdujo en la versión 10.0.10240.0) Xbox One Extensions for the UWP (se introdujo en la versión 10.0.10240.0) Windows Desktop Extension SDK (se introdujo en la versión 10.0.16299.0)
API contract	Windows.Networking.XboxLive.XboxLiveSecureSocketsContract (se introdujo en la versión v1.0)

Comentarios

No se crean instancias de esta clase mediante un constructor. En su lugar, usa uno de los métodos CreateEndpointPairAsync o CreateEndpointPairForPorts en la clase XboxLiveEndpointPairTemplate , para crear un par de puntos de conexión que siga una plantilla de comunicación determinada.

Propiedades

LocalHostName	Importante Esta API no está disponible para todas las aplicaciones. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.
LocalPort	Obtiene el puerto del punto de conexión local. Importante Esta API no está disponible para todas las aplicaciones. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.
RemoteDeviceAddress	Obtiene xboxLiveDeviceAddress para el punto de conexión remoto. Importante Esta API no está disponible para todas las aplicaciones. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.
RemoteHostName	Obtiene un hostName para el punto de conexión remoto. Importante Esta API no está disponible para todas las aplicaciones. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.
RemotePort	Obtiene el puerto del punto de conexión remoto. Importante Esta API no está disponible para todas las aplicaciones. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.
State	Obtiene un valor que representa el estado de este XboxLiveEndpointPair. Importante Esta API no está disponible para todas las aplicaciones. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.
Template	Obtiene la XboxLiveEndpointPairTemplate usada para crear instancias de este par de puntos de conexión. Importante Esta API no está disponible para todas las aplicaciones. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.

Métodos

DeleteAsync()	Comienza a terminar correctamente la relación de seguridad XboxLiveEndpointPair entre los dos puntos de conexión. Se realiza un intento de mejor esfuerzo para notificar al dispositivo remoto, aunque no hay ninguna garantía de que esta notificación se reciba si el dispositivo remoto ya no está disponible o es accesible. En su lugar, el dispositivo remoto podría agotar el tiempo de espera de XboxLiveEndpointPair. La acción se completará correctamente independientemente del dispositivo remoto o del estado anterior de XboxLiveEndpointPair. Importante Esta API no está disponible para todas las aplicaciones. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.
FindEndpointPairByHostNamesAndPorts(HostName, String, HostName, String)	Busca una instancia de XboxLiveEndpointPair existente, si existe, asociada al tráfico de un primer host y puerto a un segundo host y puerto. Usa este método para trabajar hacia atrás desde el tráfico entrante a XboxLiveEndpointPair asociado a ese tráfico. Importante Esta API no está disponible para todas las aplicaciones. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.
FindEndpointPairBySocketAddressBytes(Byte[], Byte[])	Busca una instancia de XboxLiveEndpointPair existente, si existe, asociada al tráfico entre dos direcciones de socket dadas, donde las direcciones de socket se proporcionan como matrices de Bytes que contienen Winsock SOCKADDR_STORAGE o estructuras relacionadas. Usa este método para trabajar hacia atrás desde el tráfico entrante a XboxLiveEndpointPair asociado con ese tráfico. Importante Esta API no está disponible para todas las aplicaciones. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.
GetLocalSocketAddressBytes(Byte[])	Obtiene la información de dirección del socket del punto de conexión local como una matriz de Bytes. Este método rellena el búfer de bytes especificado con la dirección SOCKADDR_STORAGE del dispositivo local para su uso en las operaciones posteriores de Winsock que aprovechan la API de redes multijugador de Xbox Live. Importante Esta API no está disponible para todas las aplicaciones. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.
GetRemoteSocketAddressBytes(Byte[])	Obtiene la información de dirección del socket del punto de conexión remoto, como una matriz de Bytes. Este método rellena el búfer de bytes especificado con la dirección SOCKADDR_STORAGE del dispositivo remoto para su uso en las operaciones posteriores de Winsock que aprovechan la API de redes multijugador de Xbox Live. Importante Esta API no está disponible para todas las aplicaciones. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.

Eventos

StateChanged

Evento generado cuando cambia el estado de XboxLiveEndpointPair . Importante Esta API no está disponible para todas las aplicaciones. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.