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

Résout et valide un chemin de dossier distant sans effectuer l'inscription du jeu auprès de la plateforme.

## Syntaxe

```cpp theme={null}
HRESULT WdRegisterRemoteXboxGame(  
         _In_z_ const char* remoteDevice,  
         _In_z_ const char* remoteFolderPath,  
         _In_opt_z_ const char* commonRootAlias  
);  
```

### Paramètres

`_In_z_ remoteDevice`\
Type : **const char\***

Nom d'hôte ou adresse IP de l'appareil distant (par exemple, `"192.168.1.100"` ou `"MyDevKit"`).

`_In_z_ remoteFolderPath`\
Type : **const char\***

Chemin d'accès, sur l'appareil distant, au dossier à valider (par exemple, `"D:\\Games\\MyGame"` ou `"MyGame"` lors de l'utilisation d'une racine commune). Si `remoteFolderPath` est un chemin absolu, `commonRootAlias` est ignoré.

`_In_opt_z_ commonRootAlias`\
Type : **const char\***

Facultatif. Alias d'un répertoire racine commun sur l'appareil distant. Passez `nullptr` pour utiliser l'emplacement de racine commune par défaut.

### Valeur de retour

Type : **HRESULT**

Renvoie `S_OK` en cas de réussite ; sinon, renvoie un code d'erreur.

#### Codes d'erreur

| Code | Valeur | Description | Cause racine | Résolution des problèmes |
| - | - | - | - | - |
| E\_OUTSIDEGAMEROOT | 0x8C114001 | Le chemin se trouve en dehors de GameRoot ; accès refusé. | `remoteFolderPath` est un chemin relatif qui se résout en dehors de la racine commune autorisée, ou `commonRootAlias` ne correspond à aucune racine commune configurée sur l'appareil distant. | Utilisez un chemin qui se résout à l'intérieur de la racine commune ; Passez un `commonRootAlias` qui existe sur l'appareil distant et qui contient le chemin |
| 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 l'ordinateur distant | Vérifiez la connectivité réseau, les règles de pare-feu et la disponibilité du service sur l'ordinateur distant ; Vérifiez la visibilité entre les appareils, qui doivent pouvoir s'envoyer des pings ; Réessayez la connexion avec la journalisation activée. |
| E\_NAMERESOLUTIONFAILED | 0x8C114012 | Impossible de résoudre le nom de l'ordinateur distant. | 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 fournie incorrecte, mal formée ou non prise en charge (par exemple, format IP incorrect, IP erronée ou protocole non pris en charge). | Confirmez que l'adresse IP est correcte ; Corrigez le format de l'adresse et assurez-vous qu'elle utilise le protocole IPv4 |
| 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 démarré avant la fin du processus d'appairage | Terminez correctement le processus d'appairage par code PIN ; 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 démarré avant la fin du processus d'appairage | Terminez correctement le processus d'appairage par code PIN ; Exécutez à nouveau la demande de connexion |
| 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 |

## Remarques

`WdRegisterRemoteXboxGame` résout le chemin distant ; elle n'inspecte pas le contenu d'un package de jeu.

La validation s'applique uniquement lorsque `remoteFolderPath` est un chemin relatif. Dans ce cas, le chemin résolu doit se trouver dans la racine commune autorisée, et `E_OUTSIDEGAMEROOT` est renvoyé si ce n'est pas le cas, ou si `commonRootAlias` ne correspond à aucune racine commune configurée sur l'appareil distant. Un `remoteFolderPath` absolu est normalisé et accepté sans vérification d'existence ni d'appartenance ; une valeur de retour `S_OK` n'indique donc pas que le dossier existe sur l'appareil distant.

<Note>L'inscription n'est actuellement pas requise pour lancer un jeu avec [WdLaunchRemoteGame](/fr/reference/remoting/functions/wdlaunchremotegame).  </Note>

## Configuration requise

| Exigence | Valeur |
| - | - |
| **En-tête** | WdRemoteIteration.h |
| **Bibliothèque** | wdremoteapi.lib |
| **Système d'exploitation pris en charge** | Windows 11 et versions ultérieures |
| **Architectures prises en charge** | x64, ARM64 |

## Voir aussi

* [WdLaunchRemoteGame](/fr/reference/remoting/functions/wdlaunchremotegame)
* [WdRemoteCopy](/fr/reference/remoting/functions/wdremotecopy)
* [Codes d'erreur de l'API XBOX PC Remote Iteration](/fr/reference/remoting/error-codes)
* [API XBOX PC Remote Iteration](/fr/reference/remoting/remoteiteration_members)


## Related topics

- [WdRegisterRemoteXboxGame](/reference/remoting/functions/wdregisterremotexboxgame.md)
- [XBOX PC Remote Iteration API](/reference/remoting/remoteiteration_members.md)
- [API XBOX PC Remote Iteration](/es/reference/remoting/remoteiteration_members.md)