XboxLiveEndpointPairTemplate Clase

Definición

Representa un patrón preconfigurado para habilitar la comunicación óptima y segura entre dos dispositivos mediante sockets. La plantilla definida por esta clase detalla cómo se conectan dos puntos de conexión en un XboxLiveEndpointPair. Las plantillas se declaran estáticamente en el manifiesto de red de la aplicación y, posteriormente, se identifican mediante cadenas de nombre únicas.

Nota:

Las plantillas solo se declaran en el manifiesto de red de la aplicación. No se puede declarar ni modificar una plantilla en tiempo de ejecució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.

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
Herencia
Object Platform::Object IInspectable XboxLiveEndpointPairTemplate
Atributos

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

El código no crea instancias de esta clase mediante un constructor. En su lugar, creas una instancia de una plantilla predefinida determinada llamando al método estático XboxLiveEndpointPairTemplate.GetTemplateByName con el nombre de la plantilla que quieras.

Propiedades

AcceptorBoundPortRangeLower

Obtiene el límite inferior del intervalo de puertos enlazados al aceptador, tal y como se define en el manifiesto de red de la aplicació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.

AcceptorBoundPortRangeUpper

Obtiene el límite superior del intervalo de puertos enlazados al aceptador, tal y como se define en el manifiesto de red de la aplicació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.

EndpointPairs

Propiedad estática que obtiene una lista de objetos XboxLiveEndpointPair actuales que se han creado con esta plantilla.

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.

InitiatorBoundPortRangeLower

Obtiene el límite inferior del intervalo de puertos enlazados al iniciador, tal como se define en el manifiesto de red de la aplicació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.

InitiatorBoundPortRangeUpper

Obtiene el límite superior del intervalo de puertos enlazados al iniciador, tal como se define en el manifiesto de red de la aplicació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.

Name

Obtiene el nombre de la plantilla (declarada en el manifiesto de red de la aplicación) que se usó para crear instancias de este objeto.

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.

SocketKind

Obtiene un valor que especifica el tipo de socket declarado por esta plantilla.

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.

Templates

Propiedad estática que muestra todas las plantillas declaradas por la aplicación. Las plantillas se declaran en el manifiesto de red de la aplicación en tiempo de compilación y no se pueden declarar ni modificar en tiempo de ejecució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

CreateEndpointPairAsync(XboxLiveDeviceAddress)

Crea un XboxLiveEndpointPair entre el dispositivo local y un dispositivo remoto especificado, basado en la plantilla actual, con el comportamiento de creación XboxLiveEndpointPairCreationBehaviors.None.

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.

CreateEndpointPairAsync(XboxLiveDeviceAddress, XboxLiveEndpointPairCreationBehaviors)

Crea un XboxLiveEndpointPair entre el dispositivo local y un dispositivo remoto especificado, al tiempo que especifica cómo debe comportarse el sistema si ya existe un XboxLiveEndpointPair para esta plantilla y dispositivo 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.

CreateEndpointPairForPortsAsync(XboxLiveDeviceAddress, String, String)

Crea un par de puntos de conexión entre el dispositivo local y el dispositivo remoto especificado, especificando puertos específicos del intervalo designado de puertos aceptables de la plantilla, con el comportamiento de creación XboxLiveEndpointPairCreationBehaviors.None.

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.

CreateEndpointPairForPortsAsync(XboxLiveDeviceAddress, String, String, XboxLiveEndpointPairCreationBehaviors)

Crea un par de puntos de conexión entre el dispositivo local y el dispositivo remoto especificado, especificando puertos específicos de los intervalos designados de la plantilla de puertos aceptables y especificando cómo debe comportarse el sistema si ya existe un xboxLiveEndpointPair para esta plantilla, dispositivo remoto y combinación de puertos.

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.

GetTemplateByName(String)

Método estático que crea una xboxLiveEndpointPairTemplate para la plantilla con nombre. Las plantillas se definen en el manifiesto de red de la aplicación. A cada plantilla del manifiesto se le debe haber asignado un nombre único.

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

InboundEndpointPairCreated

Evento generado cuando un dispositivo remoto crea correctamente un par de puntos de conexión desde sí mismo a la máquina local. Los detalles sobre el nuevo par de puntos de conexión se pueden encontrar en los argumentos del evento.

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.

Se aplica a