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

Conecta um usuário, especificado pelo endereço de email, e adiciona o usuário ao console, se necessário.

<Info>Nesta versão, o texto da senha não é criptografado quando é passado pela rede para o console por este método. Se esse comportamento for uma preocupação no seu ambiente de rede, use o método [AddUser](/pt-BR/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/adduser-ixtfuserclient-xtfuser-xbox-windows-m) para adicionar o usuário ao console e, em seguida, use o aplicativo de entrada no console para conectar o usuário e armazenar a senha do usuário. (O aplicativo de entrada envia a senha criptografada pela rede.) Posteriormente, você poderá usar este método para entrar sem passar uma senha.</Info>

<a id="syntaxSection" />

## Sintaxe

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

<a id="ID4E1" />

<a id="parametersSection" />

### Parâmetros

*emailAddress*\
Tipo: LPCWSTR

O endereço de email do usuário.

*password*\
Tipo: LPCWSTR

A senha a ser usada para entrar. Se uma senha tiver sido armazenada no console para esse usuário, passe `nullptr` para entrar com a senha armazenada.

*bStorePassword*\
Tipo: BOOL

Se TRUE, salva a senha especificada no console para uso posterior.

*pUserId*\
Tipo: UINT32 \*

Após a entrada bem-sucedida, aponta para a ID de usuário do usuário.

<a id="ID4EDB" />

<a id="retvalSection" />

### Valor retornado

Tipo: HRESULT

Código de sucesso ou de erro HRESULT.

<a id="remarks" />

<a id="remarksSection" />

## Comentários

Se o usuário já estiver conectado, chamar este método não terá efeito.

Este método pode retornar os seguintes códigos de erro.

| Código de erro | Significado |
| - | - |
| 0x80048823 | O endereço de email não é válido. |
| 0x8004882E | A senha do usuário especificado não está armazenada no console. Você deve fornecer uma senha como parte da operação de entrada. |
| 0x80048821 | A senha especificada para o usuário é inválida. |
| 0x8015DC16 | O usuário está conectado em outro console. |

Para conectar um usuário especificando uma ID de usuário, use [SigninUserId](/pt-BR/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signinuserid-ixtfuserclient-xtfuser-xbox-windows-m).

Para desconectar um usuário, use [SignoutUser](/pt-BR/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signoutuser-ixtfuserclient-xtfuser-xbox-windows-m) ou [SignoutUserId](/pt-BR/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signoutuserid-ixtfuserclient-xtfuser-xbox-windows-m).

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** xtfuser.h

**Biblioteca:** xtfuser.lib

**Plataformas com suporte:** Windows (para ferramentas de console XBOX)

<a id="seealsoSection" />

## Confira também

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


## Related topics

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