Codes d’erreur de l’API XBOX PC Remote Iteration
Le tableau suivant répertorie tous les codes d’erreur propres à l’API XBOX PC Remote Iteration. Ces codes d’erreur sont renvoyés sous forme de valeursHRESULT par les fonctions de l’API. En plus de ces codes propres à l’API, les fonctions peuvent également renvoyer des valeurs HRESULT standard telles que E_INVALIDARG ou E_OUTOFMEMORY.
| Nom de l’erreur | Valeur hexadécimale | Description | Cause première | Dépannage |
|---|---|---|---|---|
| E_OUTSIDEGAMEROOT | 0x8C114001 | Le chemin se trouve en dehors de GameRoot ; accès refusé. | Un chemin relatif a été résolu en dehors de la racine commune autorisée, ou l’alias de racine commune spécifié est introuvable | Utilisez un chemin qui se résout à l’intérieur de la racine commune ; vérifiez que l’alias de racine commune existe sur l’appareil distant |
| E_PROCESSNOTFOUND | 0x8C114002 | Processus introuvable. | Aucun processus correspondant à l’ID de processus fourni n’existe | Vérifiez l’ID du processus cible en consultant la liste des processus en cours d’exécution ; fournissez un ID de processus valide correspondant à un processus actif |
| E_INVALIDPROCESSID | 0x8C114003 | ID de processus non valide. | L’ID de processus fourni ne respecte pas le format imposé ; il doit s’agir d’une valeur numérique | Fournissez un ID de processus valide contenant uniquement des chiffres |
| E_INVALIDPIN | 0x8C114004 | Le code PIN n’est pas au format approprié. | Le code PIN fourni ne respecte pas le format imposé, par exemple parce qu’il comporte plus ou moins de 6 caractères ou utilise des caractères Unicode non pris en charge | Saisissez le code PIN correct sur l’appareil client |
| E_INVALIDSSHKEY | 0x8C114005 | La clé SSH n’est pas au format attendu. | Le champ de clé SSH fourni ne respecte pas le format attendu : type de clé - clé publique encodée en Base64 - commentaire | Générez une clé publique SSH valide ; relancez l’appairage en fournissant le chemin de la clé valide |
| E_PAIRINGTIMEOUT | 0x8C114006 | Le mode d’appairage a dépassé la durée maximale. | L’utilisateur voit cette erreur s’il met plus de 2 minutes à terminer l’appairage par code PIN | Redémarrez le processus d’appairage par code PIN ; saisissez le code PIN sur l’appareil client avant l’expiration du délai (2 min) |
| E_TOOMANYFAILURES | 0x8C114007 | Trop de tentatives de code PIN infructueuses. | L’utilisateur voit cette erreur s’il n’a pas réussi à saisir le code PIN correct 3 fois ou plus | Redémarrez le processus d’appairage par code PIN ; saisissez le code PIN correct sur l’appareil client |
| E_CLIENTNOTAUTHORIZED | 0x8C114008 | L’appareil a rejeté le client. | Le client ne figure pas dans la liste des clients approuvés de l’appareil. La tentative de connexion a été lancée avant la fin du processus d’appairage | Terminez correctement le processus d’appairage par code PIN ; relancez la demande de connexion |
| E_SERVERNOTAUTHORIZED | 0x8C114009 | Le client a rejeté l’appareil. | L’appareil cible ne figure pas dans la liste des points de terminaison approuvés du client. La tentative de connexion a été lancée avant la fin du processus d’appairage | Terminez correctement le processus d’appairage par code PIN ; relancez la demande de connexion |
| E_SSHKEYTOOLARGE | 0x8C11400A | Clé SSH trop volumineuse. | Le fichier de clé SSH fourni dépasse la taille prise en charge par le point de terminaison, soit 16 384 octets (généralement en raison de clés RSA héritées ou de blobs de clés mal formés). | Générez une nouvelle clé SSH à l’aide d’un algorithme et d’une taille pris en charge (par exemple, ED25519 ou RSA‑2048) ; assurez-vous que la bonne clé est spécifiée pour la connexion RIT |
| E_GAMENOTSUSPENDED | 0x8C11400B | Le processus spécifié ne peut pas être repris. | Tentative de reprise d’un processus qui n’est pas dans un état suspendu ou dont le contexte de suspension n’est plus valide. | Vérifiez l’état du processus avant de le reprendre ; assurez-vous qu’aucun autre outil n’a déjà repris ou arrêté le processus |
| E_GAMEOVERSUSPENDED | 0x8C11400D | Le nombre de suspensions du thread n’est pas égal à zéro. | Le thread a été suspendu plusieurs fois et n’a pas été entièrement repris. La sémantique de suspension des threads Windows exige des appels de reprise équilibrés. | Reprenez le thread à plusieurs reprises jusqu’à ce que le nombre de suspensions atteigne zéro, ou redémarrez le processus pour réinitialiser l’état du thread. ; vous pouvez aussi redémarrer le processus pour réinitialiser l’état du thread |
| E_GAMESTILLRUNNING | 0x8C11400E | Un seul jeu peut s’exécuter à la fois. | Tentative de lancement d’un nouveau processus alors qu’un processus inscrit comme jeu est déjà en cours d’exécution. RIT impose un seul processus de jeu actif pour prendre en charge le paramètre un jeu à la fois (OGAT) | Assurez-vous qu’aucun processus de jeu précédent n’est en cours d’exécution ; arrêtez le jeu en cours d’exécution (le cas échéant) avant d’en lancer un autre ; réessayez de lancer le processus de jeu |
| E_GAMEEXITABANDONED | 0x8C11400F | Abandon de l’attente de la fermeture du jeu. | L’arrêt du processus de jeu s’est bloqué et aucun code de sortie n’a été renvoyé | Vérifiez si le processus de jeu est toujours en cours d’exécution ; vérifiez que les bons ID de processus et de thread ont été fournis pour l’arrêt ; réessayez d’arrêter le processus |
| E_GAMEFILEPATHNOTEXIST | 0x8C114010 | Le chemin du fichier de jeu n’existe pas. | Le chemin de l’exécutable ou du package de jeu fourni n’est pas valide ou est inaccessible sur la machine distante. | Vérifiez que le chemin existe sur l’appareil distant ; confirmez que le déploiement a réussi |
| E_SERVERTOOOLD | 0x8C114011 | La version du serveur est trop ancienne pour ce client. | La version de l’API côté client est plus récente que la version du point de terminaison sur l’appareil distant | Mettez à jour wdEndpoint vers la dernière version sur la machine distante |
| E_NAMERESOLUTIONFAILED | 0x8C114012 | Impossible de résoudre le nom de la machine distante. | Le nom d’hôte ne peut pas être résolu via DNS ou la résolution de noms locale. | Vérifiez l’orthographe du nom d’hôte, la configuration DNS et la connectivité réseau. ; utilisez l’adresse IP pour isoler les problèmes de résolution de noms. |
| E_INVALIDADDRESS | 0x8C114013 | Adresse non valide. | Adresse réseau incorrecte, mal formée ou non prise en charge (par exemple, format IP incorrect, mauvaise adresse IP ou protocole non pris en charge). | Confirmez l’adresse IP correcte ; corrigez le format de l’adresse et assurez-vous qu’elle utilise le protocole IPv4 |
| E_CONNECTIONERROR | 0x8C114014 | Erreur de connexion. | Échec générique lors de l’établissement de la connexion réseau (échec au niveau du transport), sans rapport avec la validité de l’adresse IP ou la résolution du nom de la machine distante | Vérifiez la connectivité réseau, les règles de pare-feu et la disponibilité du service sur la machine distante ; vérifiez la visibilité entre les appareils, qui doivent pouvoir s’envoyer des pings ; réessayez la connexion avec la journalisation activée. |
| E_LISTENERALREADYRUNNING | 0x8C114015 | Un autre écouteur est actif. | Une autre instance du point de terminaison est déjà en cours d’exécution sur l’appareil distant | - Arrêtez l’instance en cours d’exécution du point de terminaison avant d’en lancer une nouvelle ; vous pouvez aussi utiliser l’instance du point de terminaison déjà en cours d’exécution au lieu d’en lancer une nouvelle |
| E_ADMIN_REQUIRED | 0x8C114016 | Privilèges d’administrateur requis. | Le point de terminaison ne s’exécute pas avec des privilèges élevés et l’opération nécessite des autorisations de niveau administrateur | Réexécutez le point de terminaison en tant qu’administrateur |
| E_INVALIDTHREADID | 0x8C114017 | ID de thread non valide. | L’ID de thread fourni ne respecte pas le format attendu ; il doit s’agir d’une valeur numérique | Fournissez un ID de thread valide contenant uniquement des chiffres |
| E_INVALIDPIDTID_PAIR | 0x8C114018 | L’ID de processus donné n’est pas associé à l’ID de thread donné. | L’ID de thread existe, mais il n’appartient pas au processus spécifié. | Réinterrogez la liste des threads du processus ; assurez-vous que les ID ne sont pas mis en cache ou obsolètes. ; vérifiez que l’ID de thread a été obtenu à partir du bon contexte de processus. |
| E_THREADNOTFOUND | 0x8C114019 | Thread introuvable. | L’ID de thread fourni ne correspond à aucun thread existant dans le processus cible. Le thread s’est peut-être déjà terminé ou n’a jamais été valide. | Réinterrogez la liste des threads du processus ; assurez-vous que les ID ne sont pas mis en cache ou obsolètes. ; vérifiez que l’ID de thread a été obtenu à partir du bon contexte de processus. |