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

# XUserGetGamertag

> XUserGetGamertag

# XUserGetGamertag

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

## Syntaxe

```cpp theme={null}
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](/fr/reference/system/xuser/enums/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](/fr/reference/system/xuser/functions/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](/fr/reference/errorcodes).

## Remarques

Pour récupérer l'ID d'utilisateur d'un utilisateur spécifique, appelez [XUserGetId](/fr/reference/system/xuser/functions/xusergetid).

Pour récupérer l'état d'un utilisateur spécifique, appelez [XUserGetState](/fr/reference/system/xuser/functions/xusergetstate).

Pour récupérer la tranche d'âge d'un utilisateur spécifique, appelez [XUserGetAgeGroup](/fr/reference/system/xuser/functions/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](/fr/reference/system/xuser/xuser_members)

[XUserGetId](/fr/reference/system/xuser/functions/xusergetid)

[XUserGetState](/fr/reference/system/xuser/functions/xusergetstate)

[XUserGetAgeGroup](/fr/reference/system/xuser/functions/xusergetagegroup)


## Related topics

- [XUserGetGamertag](/reference/system/xuser/functions/xusergetgamertag.md)
- [XUserGamertagComponent](/reference/system/xuser/enums/xusergamertagcomponent.md)
- [Gamertags overview](/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-gamertags-overview.md)
- [Best practices and testing for modern gamertags](/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-modern-gamertags-best-practices-and-testing.md)
- [Procedimientos recomendados y pruebas para gamertags modernos](/es/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-modern-gamertags-best-practices-and-testing.md)