> ## 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 courriel, et ajoute l'utilisateur à 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-CA/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 connecter l'utilisateur 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

L'adresse courriel de l'utilisateur.

*password*\
Type : LPCWSTR

Le 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 retourner les codes d'erreur suivants.

| Code d'erreur | Signification |
| - | - |
| 0x80048823 | L'adresse courriel 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-CA/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signinuserid-ixtfuserclient-xtfuser-xbox-windows-m).

Pour déconnecter un utilisateur, utilisez [SignoutUser](/fr-CA/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signoutuser-ixtfuserclient-xtfuser-xbox-windows-m) ou [SignoutUserId](/fr-CA/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-CA/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t)


## Related topics

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