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