> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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 donné.

## 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 il faut récupérer le gamertag.

*gamertagComponent*   \_In\_\
Type : [XUserGamertagComponent](https://docs.xbox.com/fr-CA/reference/system/xuser/enums/xusergamertagcomponent.md)

Type de gamertag à récupérer.

*gamertagSize*   \_In\_\
Type : size\_t

Taille en octets de la mémoire tampon du paramètre *gamertag*.

*gamertag*   \_Out\_writes\_bytes\_to\_(gamertagSize,*gamertagUsed)\
Type : char*

Contient le gamertag d'un utilisateur donné.

*gamertagUsed*   \_Out\_opt\_\
Type : size\_t\*

Contient la quantité de mémoire tampon utilisée pour contenir 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](https://docs.xbox.com/fr-CA/reference/system/xuser/functions/xuserresolveissuewithuiasync.md) 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](https://docs.xbox.com/fr-CA/reference/errorcodes.md).

## Remarques

Pour récupérer l'ID d'utilisateur d'un utilisateur donné, appelez [XUserGetId](https://docs.xbox.com/fr-CA/reference/system/xuser/functions/xusergetid.md).

Pour récupérer l'état d'un utilisateur donné, appelez [XUserGetState](https://docs.xbox.com/fr-CA/reference/system/xuser/functions/xusergetstate.md).

Pour récupérer le groupe d'âge d'un utilisateur donné, appelez [XUserGetAgeGroup](https://docs.xbox.com/fr-CA/reference/system/xuser/functions/xusergetagegroup.md).

## 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](https://docs.xbox.com/fr-CA/reference/system/xuser/xuser_members.md)

[XUserGetId](https://docs.xbox.com/fr-CA/reference/system/xuser/functions/xusergetid.md)

[XUserGetState](https://docs.xbox.com/fr-CA/reference/system/xuser/functions/xusergetstate.md)

[XUserGetAgeGroup](https://docs.xbox.com/fr-CA/reference/system/xuser/functions/xusergetagegroup.md)


## Related topics

- [XUserGamertagComponent](https://docs.xbox.com/fr-CA/reference/system/xuser/enums/xusergamertagcomponent.md)
- [Pratiques exemplaires et tests des gamertags modernes](https://docs.xbox.com/fr-CA/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-modern-gamertags-best-practices-and-testing.md)
- [Vue d'ensemble des gamertags](https://docs.xbox.com/fr-CA/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-gamertags-overview.md)
- [Exigences XBOX testées lors de la certification pour les jeux XBOX](https://docs.xbox.com/fr-CA/publishing/certification/console-cert-tested-requirements.md)
- [Exigences XBOX pour les jeux XBOX](https://docs.xbox.com/fr-CA/publishing/certification/xbox-requirements.md)