XboxLiveEndpointPairTemplate Classe

Definizione

Spazio dei nomi:

Windows.Networking.XboxLive

Rappresenta un modello preconfigurato per consentire la comunicazione ottimale e sicura tra due dispositivi tramite socket. Il modello definito da questa classe illustra in dettaglio come due endpoint sono connessi in un oggetto XboxLiveEndpointPair. I modelli vengono dichiarati in modo statico nel manifesto di rete dell'app e successivamente vengono identificati usando stringhe di nome univoche.

Nota

I modelli vengono dichiarati solo nel manifesto di rete dell'app. Non è possibile dichiarare o modificare un modello in fase di esecuzione.

Importante

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

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

Ereditarietà

Object Platform::Object IInspectable XboxLiveEndpointPairTemplate

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

Il codice non crea un'istanza di questa classe usando un costruttore. Devi invece creare un'istanza di un modello predefinito specifico chiamando il metodo statico XboxLiveEndpointPairTemplate.GetTemplateByName con il nome del modello desiderato.

Proprietà

AcceptorBoundPortRangeLower	Ottiene il limite inferiore dell'intervallo di porte associato all'acceptor, come definito nel manifesto della rete dell'app. Importante Questa API non è disponibile per tutte le app. A meno che il provisioning dell'account per sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
AcceptorBoundPortRangeUpper	Ottiene il limite superiore dell'intervallo di porte associato all'acceptor, come definito nel manifesto della rete dell'app. Importante Questa API non è disponibile per tutte le app. A meno che il provisioning dell'account per sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
EndpointPairs	Proprietà statica che ottiene un elenco degli oggetti XboxLiveEndpointPair correnti creati con questo modello. Importante Questa API non è disponibile per tutte le app. A meno che il provisioning dell'account per sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
InitiatorBoundPortRangeLower	Ottiene il limite inferiore dell'intervallo di porte associato all'iniziatore, come definito nel manifesto della rete dell'app. Importante Questa API non è disponibile per tutte le app. A meno che il provisioning dell'account per sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
InitiatorBoundPortRangeUpper	Ottiene il limite superiore dell'intervallo di porte associato all'iniziatore, come definito nel manifesto della rete dell'app. Importante Questa API non è disponibile per tutte le app. A meno che il provisioning dell'account per sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
Name	Ottiene il nome del modello (dichiarato nel manifesto della rete dell'app) utilizzato per creare un'istanza di questo oggetto. Importante Questa API non è disponibile per tutte le app. A meno che il provisioning dell'account per sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
SocketKind	Ottiene un valore che specifica il tipo di socket dichiarato da questo modello. Importante Questa API non è disponibile per tutte le app. A meno che il provisioning dell'account per sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
Templates	Proprietà statica che elenca tutti i modelli dichiarati dall'app. I modelli vengono dichiarati nel manifesto di rete dell'app in fase di compilazione e non possono essere dichiarati o modificati in fase di esecuzione. Importante Questa API non è disponibile per tutte le app. A meno che il provisioning dell'account per sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.

Metodi

CreateEndpointPairAsync(XboxLiveDeviceAddress)	Crea un oggetto XboxLiveEndpointPair tra il dispositivo locale e un dispositivo remoto specificato, in base al modello corrente, con il comportamento di creazione XboxLiveEndpointPairCreationBehaviors.None. Importante Questa API non è disponibile per tutte le app. A meno che il provisioning dell'account per sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
CreateEndpointPairAsync(XboxLiveDeviceAddress, XboxLiveEndpointPairCreationBehaviors)	Crea un oggetto XboxLiveEndpointPair tra il dispositivo locale e un dispositivo remoto specificato, specificando il comportamento del sistema se esiste già un oggetto XboxLiveEndpointPair per questo modello e un dispositivo remoto. Importante Questa API non è disponibile per tutte le app. A meno che il provisioning dell'account per sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
CreateEndpointPairForPortsAsync(XboxLiveDeviceAddress, String, String)	Crea una coppia di endpoint tra il dispositivo locale e il dispositivo remoto specificato, specificando porte specifiche dall'intervallo designato del modello di porte accettabili, con il comportamento di creazione XboxLiveEndpointPairCreationBehaviors.None. Importante Questa API non è disponibile per tutte le app. A meno che il provisioning dell'account per sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
CreateEndpointPairForPortsAsync(XboxLiveDeviceAddress, String, String, XboxLiveEndpointPairCreationBehaviors)	Crea una coppia di endpoint tra il dispositivo locale e il dispositivo remoto specificato, specificando porte specifiche dagli intervalli designati del modello di porte accettabili e specificando il comportamento del sistema se esiste già una combinazione di porta xboxLiveEndpointPair per questo modello, dispositivo remoto e combinazione di porte. Importante Questa API non è disponibile per tutte le app. A meno che il provisioning dell'account per sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
GetTemplateByName(String)	Metodo statico che crea un oggetto XboxLiveEndpointPairTemplate per il modello denominato. I modelli vengono definiti nel manifesto della rete dell'app. A ogni modello nel manifesto deve essere stato assegnato un nome univoco. Importante Questa API non è disponibile per tutte le app. A meno che il provisioning dell'account per sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.

Eventi

InboundEndpointPairCreated

Evento generato quando un dispositivo remoto crea correttamente una coppia di endpoint da se stessa al computer locale. I dettagli sulla nuova coppia di endpoint sono disponibili negli argomenti dell'evento. Importante Questa API non è disponibile per tutte le app. A meno che il provisioning dell'account per sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.