XboxLiveEndpointPair Classe

Définition

Espace de noms:

Windows.Networking.XboxLive

Un XboxLiveEndpointPair est une relation de sécurité et de qualité réseau établie entre deux appareils pour la communication basée sur les sockets.

L’API Windows.Networking.XboxLive permet la connectivité P2P (peer-to-peer) dans divers environnements, en tirant parti des technologies et services de traduction d’adresses réseau (NAT) IPv4, IPv6 et Microsoft (NAT) (tels que Teredo) pour déterminer et configurer le meilleur chemin réseau disponible entre les points de terminaison. Il établit également le chiffrement du trafic et la protection contre la falsification, comme mesure pour réduire la tricherie. En outre, il authentifie les utilisateurs et les applications via l’écosystème Xbox Live&dmash ; intégration d’informations de connectivité à d’autres services Xbox Live. Ces informations peuvent ensuite être utilisées dans la création de correspondances, pour tenter de mettre en correspondance des joueurs avec des statistiques de connectivité similaires les uns par rapport aux autres.

L’API Windows.Networking.XboxLive complète et étend les transports réseau traditionnels tels que TCP et UDP, ainsi que les API de sockets disponibles, WinSock et Windows.Networking.Sockets. Vous créez un XboxLiveEndpointPair à l’aide de cette API, puis utilisez votre API de transport préférée pour la transmission de données réelle. Le concept XboxLiveEndpointPair lui-même est lié à Windows.Networking.EndpointPair en ce sens qu’il peut être interprété comme un ensemble d’adresses IP et de ports locaux et distants ; mais avec un XboxLiveEndpointPair, ces propriétés sont en lecture seule (car le système les négocie) et ont une durée de vie de validité associée (car un XboxLiveEndpointPair représente une relation de sécurité active qui peut être arrêtée pour diverses raisons).

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

Héritage

Object Platform::Object IInspectable XboxLiveEndpointPair

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

Vous ne créez pas d’instances de cette classe à l’aide d’un constructeur. Au lieu de cela, vous utilisez l’une des méthodes CreateEndpointPairAsync ou CreateEndpointPairForPorts dans la classe XboxLiveEndpointPairTemplate , afin de créer une paire de points de terminaison qui suit un modèle de communication particulier.

Propriétés

LocalHostName	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.
LocalPort	Obtient le port du point de terminaison local. 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.
RemoteDeviceAddress	Obtient l’adresse XboxLiveDevice pour le point de terminaison 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.
RemoteHostName	Obtient un nom d’hôte pour le point de terminaison 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.
RemotePort	Obtient le port du point de terminaison 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.
State	Obtient une valeur représentant l’état de cette XboxLiveEndpointPair. 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.
Template	Obtient le XboxLiveEndpointPairTemplate utilisé pour instancier cette paire de points de terminaison. 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

DeleteAsync()	Commence à mettre fin à la relation de sécurité XboxLiveEndpointPair entre les deux points de terminaison. Une tentative de notification de l’appareil distant est effectuée, bien qu’il n’y ait aucune garantie que cette notification sera reçue si l’appareil distant n’est plus disponible ou accessible. L’appareil distant peut au lieu de cela expirer xboxLiveEndpointPair. L’action se termine avec succès, quel que soit l’appareil distant ou le status précédent de XboxLiveEndpointPair. 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.
FindEndpointPairByHostNamesAndPorts(HostName, String, HostName, String)	Recherche un instance XboxLiveEndpointPair existant, le cas échéant, associé au trafic d’un premier hôte et d’un port vers un deuxième hôte et port. Utilisez cette méthode pour revenir en arrière à partir du trafic entrant vers le XboxLiveEndpointPair associé à ce trafic. 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.
FindEndpointPairBySocketAddressBytes(Byte[], Byte[])	Recherche un XboxLiveEndpointPair existant instance, le cas échéant, associé au trafic entre deux adresses de socket données, où les adresses de socket sont fournies sous forme de tableaux d’Octet contenant des SOCKADDR_STORAGE Winsock ou des structures associées. Utilisez cette méthode pour travailler en arrière à partir du trafic entrant vers le XboxLiveEndpointPair associé à ce trafic. 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.
GetLocalSocketAddressBytes(Byte[])	Obtient les informations d’adresse de socket du point de terminaison local sous la forme d’un tableau d’octets. Cette méthode remplit la mémoire tampon d’octets spécifiée avec l’adresse SOCKADDR_STORAGE de l’appareil local pour une utilisation dans les opérations Winsock suivantes à l’aide de l’API de mise en réseau multijoueur Xbox Live. 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.
GetRemoteSocketAddressBytes(Byte[])	Obtient les informations d’adresse de socket du point de terminaison distant, sous la forme d’un tableau d’octets. Cette méthode remplit la mémoire tampon d’octets spécifiée avec l’adresse SOCKADDR_STORAGE de l’appareil distant pour une utilisation dans les opérations Winsock suivantes à l’aide de l’API de mise en réseau multijoueur Xbox Live. 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

StateChanged

Événement déclenché lorsque l’état du XboxLiveEndpointPair change . 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.