XboxLiveEndpointPairTemplate Classe

Définition

Espace de noms:

Windows.Networking.XboxLive

Représente un modèle préconfiguré pour permettre une communication optimale et sécurisée entre deux appareils à l’aide de sockets. Le modèle défini par cette classe détaille la façon dont deux points de terminaison sont connectés dans un XboxLiveEndpointPair. Les modèles sont déclarés de manière statique dans le manifeste réseau de votre application et sont ensuite identifiés à l’aide de chaînes de nom uniques.

Notes

Les modèles sont déclarés uniquement dans le manifeste réseau de l’application. Vous ne pouvez pas déclarer ou modifier un modèle au moment de l’exécution.

Important

Cette API n’est pas disponible pour toutes les applications. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.

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

Héritage

Object Platform::Object IInspectable XboxLiveEndpointPairTemplate

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Xbox One System Apps Extensions for the UWP (introduit dans 10.0.0.1) Xbox Live Extension SDK (introduit dans 10.0.10240.0) Xbox One Extensions for the UWP (introduit dans 10.0.10240.0) Windows Desktop Extension SDK (introduit dans 10.0.16299.0)
API contract	Windows.Networking.XboxLive.XboxLiveSecureSocketsContract (introduit dans v1.0)

Remarques

Votre code n’instancie pas cette classe à l’aide d’un constructeur. Au lieu de cela, vous créez une instance d’un modèle prédéfini particulier en appelant la méthode statique XboxLiveEndpointPairTemplate.GetTemplateByName avec le nom du modèle souhaité.

Propriétés

AcceptorBoundPortRangeLower	Obtient la limite inférieure de la plage de ports liés à l’accepteur, telle que définie dans le manifeste réseau de l’application. Important Cette API n’est pas disponible pour toutes les applications. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.
AcceptorBoundPortRangeUpper	Obtient la limite supérieure de la plage de ports liés à l’accepteur, telle que définie dans le manifeste réseau de l’application. Important Cette API n’est pas disponible pour toutes les applications. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.
EndpointPairs	Propriété statique qui obtient la liste des objets XboxLiveEndpointPair actuels qui ont été créés à l’aide de ce modèle. Important Cette API n’est pas disponible pour toutes les applications. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.
InitiatorBoundPortRangeLower	Obtient la limite inférieure de la plage de ports liés à l’initiateur, telle que définie dans le manifeste réseau de l’application. Important Cette API n’est pas disponible pour toutes les applications. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.
InitiatorBoundPortRangeUpper	Obtient la limite supérieure de la plage de ports liés de l’initiateur, telle que définie dans le manifeste réseau de l’application. Important Cette API n’est pas disponible pour toutes les applications. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.
Name	Obtient le nom du modèle (déclaré dans le manifeste du réseau d’application) qui a été utilisé pour instancier cet objet. Important Cette API n’est pas disponible pour toutes les applications. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.
SocketKind	Obtient une valeur spécifiant le type de socket déclaré par ce modèle. Important Cette API n’est pas disponible pour toutes les applications. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.
Templates	Propriété statique qui répertorie tous les modèles déclarés par l’application. Les modèles sont déclarés dans le manifeste réseau de l’application au moment de la génération et ne peuvent pas être déclarés ou modifiés au moment de l’exécution. Important Cette API n’est pas disponible pour toutes les applications. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.

Méthodes

CreateEndpointPairAsync(XboxLiveDeviceAddress)	Crée un XboxLiveEndpointPair entre l’appareil local et un appareil distant spécifié, en fonction du modèle actuel, avec le comportement de création XboxLiveEndpointPairCreationBehaviors.None. Important Cette API n’est pas disponible pour toutes les applications. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.
CreateEndpointPairAsync(XboxLiveDeviceAddress, XboxLiveEndpointPairCreationBehaviors)	Crée un XboxLiveEndpointPair entre l’appareil local et un appareil distant spécifié, tout en spécifiant comment le système doit se comporter si un XboxLiveEndpointPair existe déjà pour ce modèle et l’appareil distant. Important Cette API n’est pas disponible pour toutes les applications. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.
CreateEndpointPairForPortsAsync(XboxLiveDeviceAddress, String, String)	Crée une paire de points de terminaison entre l’appareil local et l’appareil distant spécifié, en spécifiant des ports spécifiques à partir de la plage désignée de ports acceptables du modèle, avec le comportement de création XboxLiveEndpointPairCreationBehaviors.None. Important Cette API n’est pas disponible pour toutes les applications. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.
CreateEndpointPairForPortsAsync(XboxLiveDeviceAddress, String, String, XboxLiveEndpointPairCreationBehaviors)	Crée une paire de points de terminaison entre l’appareil local et l’appareil distant spécifié, en spécifiant des ports spécifiques à partir des plages désignées de ports acceptables du modèle et en spécifiant la façon dont le système doit se comporter si une XboxLiveEndpointPair existe déjà pour ce modèle, cet appareil distant et cette combinaison de ports. Important Cette API n’est pas disponible pour toutes les applications. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.
GetTemplateByName(String)	Méthode statique qui crée un XboxLiveEndpointPairTemplate pour le modèle nommé. Les modèles sont définis dans le manifeste réseau d’application. Chaque modèle du manifeste doit avoir reçu un nom unique. Important Cette API n’est pas disponible pour toutes les applications. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.

Événements

InboundEndpointPairCreated

Événement déclenché lorsqu’un appareil distant crée correctement une paire de points de terminaison de lui-même vers l’ordinateur local. Vous trouverez des détails sur la nouvelle paire de points de terminaison dans les arguments d’événement. Important Cette API n’est pas disponible pour toutes les applications. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.