XUserGetGamertag

Récupère le gamertag d’un utilisateur spécifique.

Syntaxe

HRESULT XUserGetGamertag(  
         XUserHandle user,
         XUserGamertagComponent gamertagComponent,
         size_t gamertagSize,  
         char* gamertag,  
         size_t* gamertagUsed  
)  

Paramètres

user   _In_
Type : XUserHandle Handle de l’utilisateur dont le gamertag doit être récupéré. gamertagComponent   _In_
Type : XUserGamertagComponent Type de gamertag à récupérer. gamertagSize   _In_
Type : size_t Taille en octets de la mémoire tampon dans le paramètre gamertag. gamertag   _Out_writes_bytes_to_(gamertagSize,gamertagUsed)
Type : char Contient le gamertag d’un utilisateur spécifique. gamertagUsed   _Out_opt_
Type : size_t* Contient la quantité de mémoire tampon utilisée pour stocker le gamertag.

Valeur de retour

Type : HRESULT Code de réussite ou d’erreur HRESULT.

Code de retour	Description
S_OK	L’opération a réussi.
E_GAMEUSER_RESOLVE_USER_ISSUE_REQUIRED	L’utilisateur doit utiliser une interface utilisateur pour résoudre le problème. Appelez XUserResolveIssueWithUiAsync pour afficher l’interface utilisateur à l’utilisateur.
E_INSUFFICIENT_BUFFER	La taille de la mémoire tampon indiquée par gamertagSize n’est pas suffisante pour contenir le composant demandé.
E_INVALIDARG	gamertagComponent fourni non valide.

Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur.

Remarques

Pour récupérer l’ID d’utilisateur d’un utilisateur spécifique, appelez XUserGetId. Pour récupérer l’état d’un utilisateur spécifique, appelez XUserGetState. Pour récupérer la tranche d’âge d’un utilisateur spécifique, appelez XUserGetAgeGroup.

Configuration requise

En-tête : XUser.h Bibliothèque : xgameruntime.lib Plateformes prises en charge : Windows, Steam Deck, consoles de la famille XBOX One et consoles XBOX Series

Voir aussi

XUser XUserGetId XUserGetState XUserGetAgeGroup

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

XUserGetGamertag

XUserGetGamertag

Syntaxe

Paramètres

Valeur de retour

Remarques

Configuration requise

Voir aussi

​XUserGetGamertag

​Syntaxe

​Paramètres

​Valeur de retour

​Remarques

​Configuration requise

​Voir aussi

XUserGetGamertag

Syntaxe

Paramètres

Valeur de retour

Remarques

Configuration requise

Voir aussi