Compartilhar via

XboxLiveEndpointPair Classe

  • Referência

Definição

Namespace:
Windows.Networking.XboxLive
Editar

Um XboxLiveEndpointPair é uma relação de qualidade de rede e segurança estabelecida entre dois dispositivos para comunicação baseada em soquete.

A API Windows.Networking.XboxLive permite a conectividade ponto a ponto (P2P) em ambientes variados, aproveitando as tecnologias e serviços de passagem IPv4, IPv6 e NAT (Conversão de Endereços de Rede) da Microsoft (como o Teredo) para determinar e configurar o melhor caminho de rede disponível entre os pontos de extremidade. Ele também estabelece a criptografia de tráfego e proteção contra adulteração, como medida para reduzir a fraude. Além disso, ele autentica usuários e aplicativos por meio do ecossistema do Xbox Live&dmash; integrando informações de conectividade com outros serviços do Xbox Live. Essas informações podem ser usadas no matchmaking, para tentar corresponder jogadores com estatísticas de conectividade semelhantes entre si.

A API Windows.Networking.XboxLive complementa e estende os transportes de rede tradicionais, como TCP e UDP, e as APIs de soquetes disponíveis, WinSock e Windows.Networking.Sockets. Você cria um XboxLiveEndpointPair usando essa API e, em seguida, usa sua API de transporte preferencial para transmissão de dados real. O próprio conceito XboxLiveEndpointPair está relacionado a Windows.Networking.EndpointPair , pois ele pode ser interpretado como um conjunto de endereços IP locais e remotos e portas; mas com um XboxLiveEndpointPair, essas propriedades são somente leitura (porque o sistema as negocia) e têm um tempo de vida de validade associado (porque um XboxLiveEndpointPair representa uma relação de segurança ativa que pode ser encerrada por vários motivos).

Importante

Essa API não está disponível para todos os aplicativos. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.

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
Herança
Object Platform::Object IInspectable XboxLiveEndpointPair
Atributos
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos
Xbox One System Apps Extensions for the UWP (introduzida na 10.0.0.1)
 Xbox Live Extension SDK (introduzida na 10.0.10240.0)
 Xbox One Extensions for the UWP (introduzida na 10.0.10240.0)
 Windows Desktop Extension SDK (introduzida na 10.0.16299.0)
API contract
Windows.Networking.XboxLive.XboxLiveSecureSocketsContract (introduzida na v1.0)

Comentários

Você não cria instâncias dessa classe usando um construtor. Em vez disso, você faz isso usando um dos métodos CreateEndpointPairAsync ou CreateEndpointPairForPorts na classe XboxLiveEndpointPairTemplate , a fim de criar um par de pontos de extremidade que segue um modelo de comunicação específico.

Propriedades

LocalHostName

Importante

Essa API não está disponível para todos os aplicativos. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.
LocalPort

Obtém a porta para o ponto de extremidade local.

Importante

Essa API não está disponível para todos os aplicativos. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.
RemoteDeviceAddress

Obtém o XboxLiveDeviceAddress para o ponto de extremidade remoto.

Importante

Essa API não está disponível para todos os aplicativos. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.
RemoteHostName

Obtém um HostName para o ponto de extremidade remoto.

Importante

Essa API não está disponível para todos os aplicativos. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.
RemotePort

Obtém a porta do ponto de extremidade remoto.

Importante

Essa API não está disponível para todos os aplicativos. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.
State

Obtém um valor que representa o estado deste XboxLiveEndpointPair.

Importante

Essa API não está disponível para todos os aplicativos. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.
Template

Obtém o XboxLiveEndpointPairTemplate usado para instanciar esse par de pontos de extremidade.

Importante

Essa API não está disponível para todos os aplicativos. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.

Métodos

DeleteAsync()

Começa a encerrar normalmente a relação de segurança XboxLiveEndpointPair entre os dois pontos de extremidade. Uma tentativa de melhor esforço para notificar o dispositivo remoto é executada, embora não haja nenhuma garantia de que essa notificação será recebida se o dispositivo remoto não estiver mais disponível ou acessível. Em vez disso, o dispositivo remoto pode atingir o tempo limite do XboxLiveEndpointPair. A ação será concluída com êxito, independentemente do dispositivo remoto ou do status anterior do XboxLiveEndpointPair.

Importante

Essa API não está disponível para todos os aplicativos. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.
FindEndpointPairByHostNamesAndPorts(HostName, String, HostName, String)

Localiza uma instância existente do XboxLiveEndpointPair , se existir, associada ao tráfego de um primeiro host e porta para um segundo host e porta.

Use esse método para trabalhar com versões anteriores do tráfego de entrada para o XboxLiveEndpointPair associado a esse tráfego.

Importante

Essa API não está disponível para todos os aplicativos. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.
FindEndpointPairBySocketAddressBytes(Byte[], Byte[])

Localiza uma instância existente do XboxLiveEndpointPair , se existir, associada ao tráfego entre dois endereços de soquete fornecidos, em que os endereços de soquete são fornecidos como matrizes de Bytes que contêm SOCKADDR_STORAGE Winsock ou estruturas relacionadas.

Use esse método para trabalhar com versões anteriores do tráfego de entrada para o XboxLiveEndpointPair associado a esse tráfego.

Importante

Essa API não está disponível para todos os aplicativos. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.
GetLocalSocketAddressBytes(Byte[])

Obtém as informações de endereço de soquete do ponto de extremidade local como uma matriz de Bytes. Esse método preenche o buffer de bytes especificado com o endereço SOCKADDR_STORAGE do dispositivo local para uso em operações winsock subsequentes aproveitando a API de Rede Multijogador do Xbox Live.

Importante

Essa API não está disponível para todos os aplicativos. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.
GetRemoteSocketAddressBytes(Byte[])

Obtém as informações de endereço do soquete do ponto de extremidade remoto, como uma matriz de Bytes. Esse método preenche o buffer de bytes especificado com o endereço SOCKADDR_STORAGE do dispositivo remoto para uso em operações winsock subsequentes aproveitando a API de Rede Multijogador do Xbox Live.

Importante

Essa API não está disponível para todos os aplicativos. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.

Eventos

StateChanged

Evento gerado quando o estado do XboxLiveEndpointPair é alterado.

Importante

Essa API não está disponível para todos os aplicativos. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.

Aplica-se a