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

# PairControllerWithUser

> Méthode IXtfUserClient::PairControllerWithUser

# Méthode IXtfUserClient::PairControllerWithUser

Associe l'utilisateur identifié par l'adresse e-mail spécifiée à la manette ayant l'ID de manette spécifié.

## Syntaxe

```cpp theme={null}
public:
HRESULT PairControllerWithUser(
         LPCWSTR userName,
         UINT64 controllerId
)  
```

### Paramètres

*userName*\
Type : LPCWSTR

Adresse e-mail de l'utilisateur à associer à la manette.

*controllerId*\
Type : UINT64

ID de manette de la manette.

### Valeur de retour

Type : HRESULT

Code de réussite ou d'erreur HRESULT.

## Remarques

Pour obtenir l'adresse e-mail de l'utilisateur, appelez [ListUsers](https://docs.xbox.com/fr/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/listusers-ixtfuserclient-xtfuser-xbox-windows-m.md). Dans la structure [XTF\_USER\_DATA](https://docs.xbox.com/fr/reference/tools/xtf/xtfuser/structures/XTF_USER_DATA-xtfuser-xbox-windows-t.md) renvoyée, examinez le membre *pszEmailAddress*.

L'association d'une manette à l'aide de **PairControllerWithUser** est cumulative. Si un utilisateur est déjà associé à la manette, l'utilisateur spécifié par *userName* est également associé à la manette. Pour créer une association exclusive, appelez **PairControllerWithUserIdExclusive** ou **PairControllerWithUserExclusive**.

## Configuration requise

**En-tête :** xtfuser.h

**Bibliothèque :** xtfuser.lib

**Plateformes prises en charge :** Windows (pour les outils de console XBOX)

## Voir aussi

[PairControllerWithUserId](https://docs.xbox.com/fr/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuserid-ixtfuserclient-xtfuser-xbox-windows-m.md)


## Related topics

- [PairControllerWithUserId](https://docs.xbox.com/fr/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuserid-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [Interface IXtfUserClient (contenu de l'interface)](https://docs.xbox.com/fr/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t.md)
- [XUserFindControllerForUserWithUiAsync](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiasync.md)
- [XUserFindControllerForUserWithUiResult](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiresult.md)
- [Utilisation des connexions pair à pair directes](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/concepts-direct-peer-connectivity.md)