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

이메일 주소로 지정된 사용자를 로그인시키고 필요한 경우 콘솔에 사용자를 추가합니다.

<Info>이 릴리스에서는 이 메서드에 의해 콘솔로 네트워크를 통해 전송될 때 암호 텍스트가 암호화되지 않습니다. 네트워크 환경에서 이 동작이 우려되는 경우 [AddUser](/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/adduser-ixtfuserclient-xtfuser-xbox-windows-m) 메서드를 사용하여 콘솔에 사용자를 추가한 다음 콘솔의 Sign-In 앱을 사용하여 사용자를 로그인시키고 사용자 암호를 저장하세요. (Sign-In 앱은 네트워크를 통해 암호를 암호화하여 보냅니다.) 이후에 이 메서드를 사용하여 암호를 전달하지 않고 로그인할 수 있습니다.</Info>

<a id="syntaxSection" />

## Syntax

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

<a id="ID4E1" />

<a id="parametersSection" />

### Parameters

*emailAddress*\
Type: LPCWSTR

사용자의 이메일 주소입니다.

*password*\
Type: LPCWSTR

로그인에 사용할 암호입니다. 이 사용자의 암호가 콘솔에 저장되어 있는 경우, 저장된 암호로 로그인하려면 `nullptr`을 전달합니다.

*bStorePassword*\
Type: BOOL

TRUE인 경우, 지정된 암호를 나중에 사용할 수 있도록 콘솔에 저장합니다.

*pUserId*\
Type: UINT32 \*

성공적으로 로그인되면, 사용자의 사용자 ID를 가리킵니다.

<a id="ID4EDB" />

<a id="retvalSection" />

### Return value

Type: HRESULT

HRESULT 성공 또는 오류 코드.

<a id="remarks" />

<a id="remarksSection" />

## Remarks

사용자가 이미 로그인되어 있는 경우, 이 메서드를 호출해도 아무런 영향이 없습니다.

이 메서드는 다음과 같은 오류 코드를 반환할 수 있습니다.

| Error code | Meaning                                                  |
| ---------- | -------------------------------------------------------- |
| 0x80048823 | 이메일 주소가 유효하지 않습니다.                                       |
| 0x8004882E | 지정된 사용자의 암호가 콘솔에 저장되어 있지 않습니다. 로그인 작업의 일부로 암호를 제공해야 합니다. |
| 0x80048821 | 사용자에 대해 지정된 암호가 유효하지 않습니다.                               |
| 0x8015DC16 | 사용자가 다른 콘솔에 로그인되어 있습니다.                                  |

사용자 ID를 지정하여 사용자를 로그인시키려면 [SigninUserId](/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signinuserid-ixtfuserclient-xtfuser-xbox-windows-m)를 사용하세요.

사용자를 로그아웃시키려면 [SignoutUser](/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signoutuser-ixtfuserclient-xtfuser-xbox-windows-m) 또는 [SignoutUserId](/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signoutuserid-ixtfuserclient-xtfuser-xbox-windows-m)를 사용하세요.

<a id="requirementsSection" />

## Requirements

**Header:** xtfuser.h

**Library:** xtfuser.lib

**Supported platforms:** Windows(XBOX 콘솔 도구용)

<a id="seealsoSection" />

## See also

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


## Related topics

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