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* Le nom d’hôte ou l’adresse IP de l’appareil distant (p. ex., "192.168.1.100" ou "MyDevKit"). _In_z_ remoteFolderPath
Type : const char* Le chemin, sur l’appareil distant, du dossier à valider (p. ex., "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. Un alias pour 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 Retourne S_OK en cas de réussite; sinon, retourne un code d’erreur.

Codes d’erreur

Code	Valeur	Description	Cause première	Dépannage
E_OUTSIDEGAMEROOT	0x8C114001	Le chemin se trouve à l’extérieur de GameRoot; accès refusé.	`remoteFolderPath` est un chemin relatif qui se résout à l’extérieur 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 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 devraient pouvoir se joindre par ping; Relancez 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 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 fournie 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_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 correctement le processus de jumelage par NIP; Exécutez de 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 correctement le processus de jumelage par NIP; Exécutez de 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 requiert des autorisations de niveau administrateur	Exécutez de nouveau 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 à l’intérieur de la racine commune autorisée, et E_OUTSIDEGAMEROOT est retourné 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’inclusion; 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