XboxLiveEndpointPair Classe

Definizione

Spazio dei nomi:

Windows.Networking.XboxLive

Una XboxLiveEndpointPair è una relazione di sicurezza e qualità di rete stabilita tra due dispositivi per la comunicazione basata su socket.

L'API Windows.Networking.XboxLive consente la connettività peer-to-peer (P2P) in diversi ambienti, sfruttando IPv4, IPv6 e Nat (Network Address Translation) di Microsoft ,ad esempio Teredo, per determinare e configurare il percorso di rete migliore disponibile tra endpoint. Stabilisce anche la crittografia del traffico e della protezione contro la manomissione, come misura per ridurre la truffa. Inoltre, autentica utenti e applicazioni tramite l'ecosistema Xbox Live&dmash; integrazione delle informazioni di connettività con altri servizi Xbox Live. Queste informazioni possono quindi essere usate nel matchmaking, per tentare di abbinare i giocatori con statistiche di connettività simili tra loro.

L'API Windows.Networking.XboxLive integra e estende i trasporti di rete tradizionali, ad esempio TCP e UDP, e le API socket disponibili, WinSock e Windows.Networking.Sockets disponibili. Si crea un oggetto XboxLiveEndpointPair usando questa API e quindi si usa l'API di trasporto preferita per la trasmissione dei dati effettiva. Il concetto di XboxLiveEndpointPair è correlato a Windows.Networking.EndpointPair in cui può essere interpretato come set di indirizzi IP e porte locali e remoti; ma con xboxLiveEndpointPair, queste proprietà sono di sola lettura (perché il sistema li negozia) e hanno una durata di validità associata (perché un XboxLiveEndpointPair rappresenta una relazione di sicurezza attiva che può essere terminata per vari motivi).

Importante

Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.

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

Ereditarietà

Object Platform::Object IInspectable XboxLiveEndpointPair

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Xbox One System Apps Extensions for the UWP (è stato introdotto in 10.0.0.1) Xbox Live Extension SDK (è stato introdotto in 10.0.10240.0) Xbox One Extensions for the UWP (è stato introdotto in 10.0.10240.0) Windows Desktop Extension SDK (è stato introdotto in 10.0.16299.0)
API contract	Windows.Networking.XboxLive.XboxLiveSecureSocketsContract (è stato introdotto in v1.0)

Commenti

Non si creano istanze di questa classe usando un costruttore. In alternativa, si usa uno dei metodi CreateEndpointPairAsync o CreateEndpointPairForPorts nella classe XboxLiveEndpointPairTemplate per creare una coppia di endpoint che segue un modello di comunicazione specifico.

Proprietà

LocalHostName	Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
LocalPort	Ottiene la porta per l'endpoint locale. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
RemoteDeviceAddress	Ottiene XboxLiveDeviceAddress per l'endpoint remoto. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
RemoteHostName	Ottiene un hostName per l'endpoint remoto. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
RemotePort	Ottiene la porta per l'endpoint remoto. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
State	Ottiene un valore che rappresenta lo stato di XboxLiveEndpointPair. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
Template	Ottiene l'istanza di XboxLiveEndpointPairTemplate usata per creare un'istanza di questa coppia di endpoint. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.

Metodi

DeleteAsync()	Inizia a terminare correttamente la relazione di sicurezza XboxLiveEndpointPair tra i due endpoint. Un tentativo ottimale di notificare che il dispositivo remoto viene eseguito, anche se non esiste alcuna garanzia che questa notifica venga ricevuta se il dispositivo remoto non è più disponibile o raggiungibile. Il dispositivo remoto potrebbe invece timeout per XboxLiveEndpointPair. L'azione verrà completata correttamente indipendentemente dal dispositivo remoto o dallo stato precedente di XboxLiveEndpointPair. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
FindEndpointPairByHostNamesAndPorts(HostName, String, HostName, String)	Trova un'istanza di XboxLiveEndpointPair esistente, se presente, associata al traffico da un primo host e una porta a un secondo host e porta. Usare questo metodo per tornare indietro dal traffico in ingresso a XboxLiveEndpointPair associato a tale traffico. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
FindEndpointPairBySocketAddressBytes(Byte[], Byte[])	Trova un'istanza di XboxLiveEndpointPair esistente, se presente, associata al traffico tra due indirizzi socket specificati, in cui gli indirizzi socket vengono forniti come matrici di Byte contenenti Winsock SOCKADDR_STORAGE o strutture correlate. Usare questo metodo per lavorare indietro dal traffico in ingresso a XboxLiveEndpointPair associato a tale traffico. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
GetLocalSocketAddressBytes(Byte[])	Ottiene le informazioni sull'indirizzo socket dell'endpoint locale come matrice di Byte. Questo metodo riempie il buffer di byte specificato con l'indirizzo SOCKADDR_STORAGE del dispositivo locale da usare nelle successive operazioni Winsock sfruttando l'API Di rete multiplayer Xbox Live. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
GetRemoteSocketAddressBytes(Byte[])	Ottiene le informazioni sull'indirizzo socket dell'endpoint remoto, come matrice di Byte. Questo metodo riempie il buffer di byte specificato con l'indirizzo SOCKADDR_STORAGE del dispositivo remoto da usare nelle operazioni Winsock successive sfruttando l'API Di rete multiplayer Xbox Live. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.

Eventi

StateChanged

Evento generato quando lo stato di XboxLiveEndpointPair cambia. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.