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 retournés sous forme de valeursHRESULT par les fonctions de l’API. En plus de ces codes propres à l’API, les fonctions peuvent également retourner 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 est 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 d’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 NIP n’est pas au bon format. | Le NIP fourni ne respecte pas le format imposé, par exemple s’il compte plus ou moins de 6 caractères ou s’il utilise des caractères Unicode non pris en charge | Saisissez le bon NIP sur l’appareil client |
| E_INVALIDSSHKEY | 0x8C114005 | La clé SSH n’est pas sous la forme attendue. | 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; Exécutez à nouveau le jumelage en fournissant le chemin vers la clé valide |
| E_PAIRINGTIMEOUT | 0x8C114006 | Le mode de jumelage a dépassé la durée maximale. | L’utilisateur verra cette erreur s’il prend plus de 2 minutes pour terminer le jumelage par NIP | Redémarrez le processus de jumelage par NIP; Saisissez le NIP sur l’appareil client avant l’expiration du délai (2 min) |
| E_TOOMANYFAILURES | 0x8C114007 | Trop de tentatives de NIP échouées. | L’utilisateur verra cette erreur s’il n’a pas réussi à saisir le bon NIP 3 fois ou plus | Redémarrez le processus de jumelage par NIP; Saisissez le bon NIP 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 de jumelage | Terminez avec succès le processus de jumelage par NIP; Exécutez à nouveau 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 de jumelage | Terminez avec succès le processus de jumelage par NIP; Exécutez à nouveau 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é mal formés). | Générez une nouvelle clé SSH à l’aide d’un algorithme et d’une taille pris en charge (p. ex., 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 nul. | 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 être exécuté à 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 afin de 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 du jeu |
| E_GAMEEXITABANDONED | 0x8C11400F | Abandon de l’attente de la fermeture du jeu. | L’arrêt du processus du jeu s’est bloqué et aucun code de sortie n’a été retourné | Vérifiez si le processus du 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 du jeu n’existe pas. | Le chemin de l’exécutable ou du package du jeu fourni n’est pas valide ou est inaccessible sur l’ordinateur distant. | 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 l’ordinateur distant |
| E_NAMERESOLUTIONFAILED | 0x8C114012 | Impossible de résoudre le nom de l’ordinateur distant. | Le nom d’hôte ne peut pas être résolu au moyen du DNS ou de 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 (p. ex., format IP incorrect, mauvaise adresse IP ou protocole non pris en charge). | Confirmez que l’adresse IP est la bonne; 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 lien avec la validité de l’adresse IP ou la résolution du nom de l’ordinateur distant | Vérifiez la connectivité réseau, les règles du pare-feu et la disponibilité du service sur l’ordinateur distant; Vérifiez la visibilité entre les appareils, qui doivent pouvoir s’envoyer des requêtes ping; 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 existante 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 exige des autorisations de niveau administrateur | Exécutez à nouveau 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é. | Interrogez à nouveau la liste des threads du processus; Assurez-vous que les ID ne sont pas mis en cache ou périmés.; 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. | Interrogez à nouveau la liste des threads du processus; Assurez-vous que les ID ne sont pas mis en cache ou périmés.; Vérifiez que l’ID de thread a été obtenu à partir du bon contexte de processus. |