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