WdRegisterRemoteXboxGame

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

Syntaxe

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.

L’inscription n’est actuellement pas requise pour lancer un jeu avec WdLaunchRemoteGame.

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

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

WdRegisterRemoteXboxGame

WdRegisterRemoteXboxGame

Syntaxe

Paramètres

Valeur de retour

Codes d’erreur

Remarques

Configuration requise

Voir aussi

​WdRegisterRemoteXboxGame

​Syntaxe

​Paramètres

​Valeur de retour

​Codes d’erreur

​Remarques

​Configuration requise

​Voir aussi

WdRegisterRemoteXboxGame

Syntaxe

Paramètres

Valeur de retour

Codes d’erreur

Remarques

Configuration requise

Voir aussi