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

# SigninUserId

> IXtfUserClient::SigninUserId

# IXtfUserClient::SigninUserId

Inicia la sesión de un usuario, especificado por identificador de usuario, y agrega el usuario a la consola si es necesario.

> [!NOTE]
>
> En esta versión, el texto de la contraseña no se cifra cuando este método lo pasa a la consola a través de la red. Si este comportamiento es un problema en su entorno de red, use el método [AddUser](https://docs.xbox.com/es/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/adduser-ixtfuserclient-xtfuser-xbox-windows-m.md) para agregar el usuario a la consola y, a continuación, use la aplicación de inicio de sesión en la consola para iniciar la sesión del usuario y almacenar la contraseña del usuario. (La aplicación de inicio de sesión envía la contraseña cifrada a través de la red.) Posteriormente, puede usar este método para iniciar sesión sin pasar una contraseña.

## Sintaxis

```cpp theme={null}
public:
HRESULT SigninUserId(
         UINT32 userId,
         LPCWSTR password,
         BOOL bStorePassword
)  
```

### Parámetros

*userId*\
Tipo: UINT32

Identificador de usuario del usuario.

*password*\
Tipo: LPCWSTR

Contraseña que se usará para iniciar sesión. Si se ha almacenado una contraseña en la consola para este usuario, pase `nullptr` para iniciar sesión con la contraseña almacenada.

*bStorePassword*\
Tipo: BOOL

Si es TRUE, guarda la contraseña especificada en la consola para su uso posterior.

### Valor devuelto

Tipo: HRESULT

Código de éxito o de error HRESULT.

## Comentarios

Si el usuario ya tiene la sesión iniciada, llamar a este método no tiene ningún efecto.

Este método puede devolver los siguientes códigos de error.

| Código de error | Significado |
| - | - |
| 0x80048823 | La dirección de correo electrónico no es válida. |
| 0x8004882E | La contraseña del usuario especificado no está almacenada en la consola. Debe proporcionar una contraseña como parte de la operación de inicio de sesión. |
| 0x80048821 | La contraseña especificada para el usuario no es válida. |
| 0x8015DC16 | El usuario tiene la sesión iniciada en otra consola. |

Para iniciar la sesión de un usuario mediante la especificación de una dirección de correo electrónico, use [SigninUser](https://docs.xbox.com/es/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signinuser-ixtfuserclient-xtfuser-xbox-windows-m.md).

Para cerrar la sesión de un usuario, use [SignoutUserId](https://docs.xbox.com/es/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signoutuserid-ixtfuserclient-xtfuser-xbox-windows-m.md) o [SignoutUser](https://docs.xbox.com/es/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signoutuser-ixtfuserclient-xtfuser-xbox-windows-m.md).

## Requisitos

**Encabezado:** xtfuser.h

**Biblioteca:** xtfuser.lib

**Plataformas compatibles:** Windows (para herramientas de consola XBOX)

## Consulte también

[Interfaz IXtfUserClient](https://docs.xbox.com/es/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t.md)


## Related topics

- [SigninUser](https://docs.xbox.com/es/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signinuser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [SignoutUserId](https://docs.xbox.com/es/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signoutuserid-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [SignoutUser](https://docs.xbox.com/es/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signoutuser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [AddUser](https://docs.xbox.com/es/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/adduser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [Interfaz IXtfUserClient (contenido de la interfaz)](https://docs.xbox.com/es/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t.md)