> ## 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.

# Códigos de erro da XBOX PC Remote Iteration API

> Lista de referência dos códigos de erro HRESULT retornados pela XBOX PC Remote Iteration API, com as causas raiz e notas de solução de problemas para cada código.

# Códigos de erro da XBOX PC Remote Iteration API

A tabela a seguir lista todos os códigos de erro específicos da XBOX PC Remote Iteration API. Esses códigos de erro são retornados como valores `HRESULT` pelas funções da API. Além desses códigos específicos da API, as funções também podem retornar valores `HRESULT` padrão, como `E_INVALIDARG` ou `E_OUTOFMEMORY`.

| Nome do erro | Valor hexadecimal | Descrição | Causa raiz | Solução de problemas |
| - | - | - | - | - |
| E\_OUTSIDEGAMEROOT | 0x8C114001 | O caminho está fora de GameRoot; acesso negado. | Um caminho relativo foi resolvido fora da raiz comum permitida, ou o alias de raiz comum especificado não foi encontrado | Use um caminho que seja resolvido dentro da raiz comum; Verifique se o alias de raiz comum existe no dispositivo remoto |
| E\_PROCESSNOTFOUND | 0x8C114002 | Processo não encontrado. | Não existe um processo correspondente à ID de processo fornecida | Verifique a ID do processo de destino consultando a lista de processos em execução; Forneça uma ID de processo válida de um processo ativo |
| E\_INVALIDPROCESSID | 0x8C114003 | ID de processo inválida. | A ID de processo fornecida não segue o formato exigido; ela deve ser um valor numérico | Forneça uma ID de processo válida contendo apenas números |
| E\_INVALIDPIN | 0x8C114004 | O PIN não está no formato adequado. | O PIN fornecido não segue o formato exigido, por exemplo, sendo maior ou menor que 6 caracteres ou usando caracteres Unicode sem suporte | Insira o PIN correto no dispositivo cliente |
| E\_INVALIDSSHKEY | 0x8C114005 | A chave SSH não está no formato esperado. | O campo de chave SSH fornecido não segue o formato esperado: tipo de chave - chave pública codificada em Base64 - comentário | Gere uma chave pública SSH válida; Execute o emparelhamento novamente fornecendo o caminho para a chave válida |
| E\_PAIRINGTIMEOUT | 0x8C114006 | O modo de emparelhamento excedeu o tempo máximo. | O usuário verá isso se levar mais de 2 minutos para concluir o emparelhamento por PIN | Reinicie o processo de emparelhamento por PIN; Insira o PIN no dispositivo cliente antes do tempo limite (2 min) |
| E\_TOOMANYFAILURES | 0x8C114007 | Muitas tentativas de PIN com falha. | O usuário verá isso se não conseguir inserir o PIN correto 3 vezes ou mais | Reinicie o processo de emparelhamento por PIN; Insira o PIN correto no dispositivo cliente |
| 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\_SSHKEYTOOLARGE | 0x8C11400A | Chave SSH muito grande. | O arquivo de chave SSH fornecido excede o tamanho de 16.384 bytes com suporte no ponto de extremidade (geralmente devido a chaves RSA herdadas ou blobs de chave malformados). | Gere uma nova chave SSH usando um algoritmo e tamanho com suporte (por exemplo, ED25519 ou RSA‑2048); Verifique se a chave correta está especificada para a conexão do RIT |
| E\_GAMENOTSUSPENDED | 0x8C11400B | O processo especificado não pode ser retomado. | Tentativa de retomar um processo que não está em estado suspenso ou cujo contexto de suspensão não é mais válido. | Verifique o estado do processo antes de retomá-lo; Verifique se nenhuma outra ferramenta já retomou ou encerrou o processo |
| E\_GAMEOVERSUSPENDED | 0x8C11400D | A contagem de suspensão do thread não é zero. | O thread foi suspenso várias vezes e não foi totalmente retomado. A semântica de suspensão de threads do Windows exige chamadas de retomada balanceadas. | Retome o thread repetidamente até que a contagem de suspensão chegue a zero ou reinicie o processo para redefinir o estado do thread.; Como alternativa, reinicie o processo para redefinir o estado do thread |
| E\_GAMESTILLRUNNING | 0x8C11400E | Apenas um jogo pode ser executado por vez. | Tentativa de iniciar um novo processo quando um processo registrado como jogo já está em execução. O RIT impõe um único processo de jogo ativo para dar suporte à configuração de um jogo por vez (OGAT) | Verifique se não há nenhum processo de jogo anterior em execução; Encerre o jogo em execução (se houver) antes de iniciar outro; Tente iniciar o processo do jogo novamente |
| E\_GAMEEXITABANDONED | 0x8C11400F | Espera pela saída do jogo abandonada. | O encerramento do processo do jogo travou e nenhum código de saída foi retornado | Verifique se o processo do jogo ainda está em execução; Verifique se a ID de processo e a ID de thread corretas foram fornecidas para o encerramento; Tente encerrar o processo novamente |
| E\_GAMEFILEPATHNOTEXIST | 0x8C114010 | O caminho do arquivo do jogo não existe. | O caminho do executável ou do pacote do jogo fornecido é inválido ou está inacessível no computador remoto. | Valide se o caminho existe no dispositivo remoto; Confirme se a implantação foi bem-sucedida |
| E\_SERVERTOOOLD | 0x8C114011 | A versão do servidor é muito antiga para este cliente. | A versão da API no lado do cliente é mais recente do que a versão do ponto de extremidade no dispositivo remoto | Atualize o wdEndpoint no computador remoto para a versão mais recente |
| E\_NAMERESOLUTIONFAILED | 0x8C114012 | Não foi possível resolver o nome do computador remoto. | O nome do host não pode ser resolvido via DNS ou resolução de nomes local. | Verifique a grafia 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 o endereço IP correto; Corrija o formato do endereço e verifique se ele usa o protocolo IPv4 |
| 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 ou à resolução do nome do computador remoto | Verifique a conectividade de rede, as regras de firewall e a disponibilidade do serviço no computador remoto; Verifique a visibilidade entre os dispositivos; eles devem conseguir executar ping um no outro; Tente a conexão novamente com o log habilitado. |
| E\_LISTENERALREADYRUNNING | 0x8C114015 | Outro ouvinte está ativo. | Outra instância do ponto de extremidade já está em execução no dispositivo remoto | - Interrompa a instância do ponto de extremidade em execução antes de iniciar uma nova; Como alternativa, use a instância do ponto de extremidade que já está em execução em vez de iniciar uma nova |
| E\_ADMIN\_REQUIRED | 0x8C114016 | Privilégios de administrador necessários. | O ponto de extremidade não está sendo executado com privilégios elevados e a operação requer permissões de nível de administrador | Execute o ponto de extremidade novamente como administrador |
| E\_INVALIDTHREADID | 0x8C114017 | ID de thread inválida. | A ID de thread fornecida não segue o formato esperado; ela deve ser um valor numérico | Forneça uma ID de thread válida contendo apenas números |
| E\_INVALIDPIDTID\_PAIR | 0x8C114018 | A ID de processo fornecida não está associada à ID de thread fornecida. | A ID de thread existe, mas não pertence ao processo especificado. | Consulte novamente a lista de threads do processo; Verifique se as IDs não estão armazenadas em cache ou desatualizadas.; Valide se a ID de thread foi obtida do contexto de processo correto. |
| E\_THREADNOTFOUND | 0x8C114019 | Thread não encontrado. | A ID de thread fornecida não corresponde a nenhum thread existente no processo de destino. O thread pode já ter sido encerrado ou nunca ter sido válido. | Consulte novamente a lista de threads do processo; Verifique se as IDs não estão armazenadas em cache ou desatualizadas.; Valide se a ID de thread foi obtida do contexto de processo correto. |

## Confira também

* [XBOX PC Remote Iteration API](/pt-BR/reference/remoting/remoteiteration_members)


## Related topics

- [Códigos de error de la API XBOX PC Remote Iteration](/es/reference/remoting/error-codes.md)
- [API XBOX PC Remote Iteration](/es/reference/remoting/remoteiteration_members.md)
- [XBOX PC Remote Iteration API](/reference/remoting/remoteiteration_members.md)
- [XBOX PC Remote Iteration API error codes](/reference/remoting/error-codes.md)
- [XBOX PC Remote Tools: notas de la versión de marzo de 2026 (2603)](/es/tools/tools-pc/xbox-pc-remote-tools/release-notes/2603.md)