> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WdRegisterRemoteXboxGame

> WdRegisterRemoteXboxGame

# WdRegisterRemoteXboxGame

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

## Sintaxe

```cpp theme={null}
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.

<Note>No momento, o registro não é necessário para iniciar um jogo com [WdLaunchRemoteGame](/pt-BR/reference/remoting/functions/wdlaunchremotegame).  </Note>

## Requisitos

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

## Confira também

* [WdLaunchRemoteGame](/pt-BR/reference/remoting/functions/wdlaunchremotegame)
* [WdRemoteCopy](/pt-BR/reference/remoting/functions/wdremotecopy)
* [Códigos de erro da XBOX PC Remote Iteration API](/pt-BR/reference/remoting/error-codes)
* [XBOX PC Remote Iteration API](/pt-BR/reference/remoting/remoteiteration_members)


## Related topics

- [XBOX PC Remote Iteration API](/pt-BR/reference/remoting/remoteiteration_members.md)
- [WdLaunchRemoteGame](/pt-BR/reference/remoting/functions/wdlaunchremotegame.md)
- [WdResumeRemoteGame](/pt-BR/reference/remoting/functions/wdresumeremotegame.md)
- [WdTerminateRemoteGame](/pt-BR/reference/remoting/functions/wdterminateremotegame.md)
- [WdRemoteCopy](/pt-BR/reference/remoting/functions/wdremotecopy.md)