전자 메일 주소로 지정된 사용자를 로그인하고 필요한 경우 콘솔에 사용자를 추가합니다.
Important
이 릴리스에서 암호 텍스트는 이 메서드에 의해 네트워크를 통해 콘솔로 전달될 때 암호화되지 않은 상태입니다. 해당 네트워크 환경에서 이런 동작이 문제가 되는 경우 AddUser 메서드를 사용하여 사용자를 콘솔에 추가하고 콘솔에서 로그인 앱으로 사용자를 로그인하고 사용자 암호를 저장합니다. (로그인 앱은 네트워크를 통해 암호화된 상태로 암호를 전송합니다.) 그 후로는 암호를 전달하지 않고 해당 메서드를 사용하여 로그인할 수 있습니다.
구문
public:
HRESULT SigninUser(
LPCWSTR emailAddress,
LPCWSTR password,
BOOL bStorePassword,
UINT32 *pUserId
)
매개 변수
emailAddress
형식: LPCWSTR
사용자의 전자 메일 주소입니다.
password
형식: LPCWSTR
로그인 시 사용되는 암호입니다. 암호가 해당 사용자에 대해 본체에 저장된 경우 nullptr을(를) 전달하여 저장된 암호로 로그인할 수 있습니다.
bStorePassword
형식: BOOL
TRUE이면 추후 사용할 수 있도록 지정한 암호를 콘솔에 저장합니다.
pUserId
형식: UINT32 *
로그인 시 사용자의 사용자 ID를 가리킵니다.
반환 값
형식: HRESULT
HRESULT 성공 또는 오류 코드입니다.
설명
사용자가 이미 로그인되어 있으면 이 방법을 호출해도 효과가 없습니다.
이 방법으로 다음을 반환할 수 있습니다.
| 오류 코드 | 의미 |
|---|---|
| 0x80048823 | 이메일 주소가 올바르지 않습니다. |
| 0x8004882E | 지정한 사용자의 암호가 본체에 저장되지 않았습니다. 로그인 작업 중에 암호를 제공해야 합니다. |
| 0x80048821 | 지정한 사용자의 암호가 잘못되었습니다. |
| 0x8015DC16 | 사용자가 다른 본체에 로그인되어 있습니다. |
사용자 ID를 지정하여 사용자를 로그인하려면 SigninUserId를 사용하세요.
사용자를 로그아웃하려면 SignoutUser 또는 SignoutUserId를 사용하세요.
요건
헤더: xtfuser.h
라이브러리: xtfuser.lib
지원되는 플랫폼: Windows(Xbox 콘솔 도구용)