WdRegisterRemoteXboxGame

Resolve e valida um caminho de pasta remota sem executar o registro do jogo na plataforma.

Sintaxe

HRESULT WdRegisterRemoteXboxGame(  
         _In_z_ const char* remoteDevice,  
         _In_z_ const char* remoteFolderPath,  
         _In_opt_z_ const char* commonRootAlias  
);  

Parâmetros

_In_z_ remoteDevice
Tipo: const char* O nome do host ou o endereço IP do dispositivo remoto (por exemplo, "192.168.1.100" ou "MyDevKit"). _In_z_ remoteFolderPath
Tipo: const char* O caminho no dispositivo remoto para a pasta a ser validada (por exemplo, "D:\\Games\\MyGame" ou "MyGame" ao usar uma raiz comum). Se remoteFolderPath for um caminho absoluto, commonRootAlias será ignorado. _In_opt_z_ commonRootAlias
Tipo: const char* Opcional. Um alias para um diretório de raiz comum no dispositivo remoto. Passe nullptr para usar o local padrão da raiz comum.

Valor retornado

Tipo: HRESULT Retorna S_OK se for bem-sucedido; caso contrário, retorna um código de erro.

Códigos de erro

Código	Valor	Descrição	Causa raiz	Solução de problemas
E_OUTSIDEGAMEROOT	0x8C114001	O caminho está fora de GameRoot; acesso negado.	`remoteFolderPath` é um caminho relativo resolvido fora da raiz comum permitida, ou `commonRootAlias` não corresponde a uma raiz comum configurada no dispositivo remoto.	Use um caminho resolvido dentro da raiz comum; Passe um `commonRootAlias` que exista no dispositivo remoto e contenha o caminho
E_CONNECTIONERROR	0x8C114014	Erro de conexão.	Falha genérica ao estabelecer a conexão de rede (falha no nível de transporte), não relacionada à validade do endereço IP nem à resolução do nome da máquina remota	Verifique a conectividade de rede, as regras de firewall e a disponibilidade do serviço na máquina remota; Verifique a visibilidade entre os dispositivos, que devem conseguir executar ping um no outro; Tente a conexão novamente com o registro em log habilitado.
E_NAMERESOLUTIONFAILED	0x8C114012	Não foi possível resolver o nome da máquina remota.	O nome do host não pode ser resolvido via DNS ou resolução de nomes local.	Verifique a ortografia do nome do host, a configuração de DNS e a conectividade de rede.; Use o endereço IP para isolar problemas de resolução de nomes.
E_INVALIDADDRESS	0x8C114013	Endereço inválido.	Foi fornecido um endereço de rede incorreto, malformado ou sem suporte (por exemplo, formato de IP inválido, IP errado ou protocolo sem suporte).	Confirme se o endereço IP está correto; Corrija o formato do endereço e verifique se ele usa o protocolo IPv4
E_CLIENTNOTAUTHORIZED	0x8C114008	O dispositivo rejeitou o cliente.	O cliente não está na lista de clientes confiáveis do dispositivo. A tentativa de conexão foi iniciada antes da conclusão do processo de emparelhamento	Conclua o processo de emparelhamento por PIN com êxito; Execute a solicitação de conexão novamente
E_SERVERNOTAUTHORIZED	0x8C114009	O cliente rejeitou o dispositivo.	O dispositivo de destino não está na lista de pontos de extremidade confiáveis do cliente. A tentativa de conexão foi iniciada antes da conclusão do processo de emparelhamento	Conclua o processo de emparelhamento por PIN com êxito; Execute a solicitação de conexão novamente
E_ADMIN_REQUIRED	0x8C114016	Privilégios de administrador necessários.	O ponto de extremidade não está em execução com privilégios elevados e a operação exige permissões de nível de Administrador	Execute o ponto de extremidade novamente como Administrador

Comentários

WdRegisterRemoteXboxGame resolve o caminho remoto; ela não inspeciona o conteúdo de um pacote de jogo. A validação se aplica somente quando remoteFolderPath é um caminho relativo. Nesse caso, o caminho resolvido deve estar dentro da raiz comum permitida, e E_OUTSIDEGAMEROOT será retornado se não estiver ou se commonRootAlias não corresponder a uma raiz comum configurada no dispositivo remoto. Um remoteFolderPath absoluto é normalizado e aceito sem verificação de existência ou de contenção; portanto, um valor retornado S_OK não indica que a pasta existe no dispositivo remoto.

No momento, o registro não é necessário para iniciar um jogo com WdLaunchRemoteGame.

Requisitos

Requisito	Valor
Cabeçalho	WdRemoteIteration.h
Biblioteca	wdremoteapi.lib
SO com suporte	Windows 11 e posterior
Arquiteturas com suporte	x64, ARM64

Porting

Build Paths

WdRegisterRemoteXboxGame

WdRegisterRemoteXboxGame

Sintaxe

Parâmetros

Valor retornado

Códigos de erro

Comentários

Requisitos

Confira também

​WdRegisterRemoteXboxGame

​Sintaxe

​Parâmetros

​Valor retornado

​Códigos de erro

​Comentários

​Requisitos

​Confira também

WdRegisterRemoteXboxGame

Sintaxe

Parâmetros

Valor retornado

Códigos de erro

Comentários

Requisitos

Confira também