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

# IXtfUserClient::SigninUser

> IXtfUserClient::SigninUser

# IXtfUserClient::SigninUser

Connecte un utilisateur spécifié par son adresse e-mail et l'ajoute à la console si nécessaire.

<Info>Dans cette version, le texte du mot de passe n'est pas chiffré lorsque cette méthode le transmet à la console sur le réseau. Si ce comportement pose problème dans votre environnement réseau, utilisez la méthode [AddUser](/fr/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/adduser-ixtfuserclient-xtfuser-xbox-windows-m) pour ajouter l'utilisateur à la console, puis utilisez l'application de connexion sur la console pour connecter l'utilisateur et stocker son mot de passe. (L'application de connexion envoie le mot de passe chiffré sur le réseau.) Vous pouvez ensuite utiliser cette méthode pour vous connecter sans transmettre de mot de passe.</Info>

<a id="syntaxSection" />

## Syntaxe

```cpp theme={null}
public:
HRESULT SigninUser(
         LPCWSTR emailAddress,
         LPCWSTR password,
         BOOL bStorePassword,
         UINT32 *pUserId
)  
```

<a id="ID4E1" />

<a id="parametersSection" />

### Paramètres

*emailAddress*\
Type : LPCWSTR

Adresse e-mail de l'utilisateur.

*password*\
Type : LPCWSTR

Mot de passe à utiliser pour la connexion. Si un mot de passe a été stocké sur la console pour cet utilisateur, passez `nullptr` pour vous connecter avec le mot de passe stocké.

*bStorePassword*\
Type : BOOL

Si TRUE, enregistre le mot de passe spécifié sur la console pour une utilisation ultérieure.

*pUserId*\
Type : UINT32 \*

En cas de connexion réussie, pointe vers l'ID d'utilisateur de l'utilisateur.

<a id="ID4EDB" />

<a id="retvalSection" />

### Valeur de retour

Type : HRESULT

Code de réussite ou d'erreur HRESULT.

<a id="remarks" />

<a id="remarksSection" />

## Remarques

Si l'utilisateur est déjà connecté, l'appel de cette méthode n'a aucun effet.

Cette méthode peut renvoyer les codes d'erreur suivants.

| Code d'erreur | Signification |
| - | - |
| 0x80048823 | L'adresse e-mail n'est pas valide. |
| 0x8004882E | Le mot de passe de l'utilisateur spécifié n'est pas stocké sur la console. Vous devez fournir un mot de passe dans le cadre de l'opération de connexion. |
| 0x80048821 | Le mot de passe spécifié pour l'utilisateur n'est pas valide. |
| 0x8015DC16 | L'utilisateur est connecté sur une autre console. |

Pour connecter un utilisateur en spécifiant un ID d'utilisateur, utilisez [SigninUserId](/fr/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signinuserid-ixtfuserclient-xtfuser-xbox-windows-m).

Pour déconnecter un utilisateur, utilisez [SignoutUser](/fr/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signoutuser-ixtfuserclient-xtfuser-xbox-windows-m) ou [SignoutUserId](/fr/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signoutuserid-ixtfuserclient-xtfuser-xbox-windows-m).

<a id="requirementsSection" />

## Configuration requise

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

**Bibliothèque :** xtfuser.lib

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

<a id="seealsoSection" />

## Voir aussi

[Interface IXtfUserClient](/fr/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t)


## Related topics

- [IXtfUserClient::SigninUserId](/fr/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signinuserid-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::SignoutUserId](/fr/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signoutuserid-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::SignoutUser](/fr/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signoutuser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [Méthode IXtfUserClient::AddUser](/fr/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/adduser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::DeleteUser](/fr/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/deleteuser-ixtfuserclient-xtfuser-xbox-windows-m.md)
