Skip to main content

XUserAddOptions

사용자를 추가하기 위한 옵션을 지정합니다.

구문

상수

설명

options를 XUserAddOptions::AddDefaultUserSilently로 설정하여 XUserAddAsync를 반복해서 호출하는 경우, 개발자가 알아야 할 몇 가지 예외적인 상황이 있습니다.
  • 이 함수를 반복해서 호출할 때 게임을 시작한 기본 사용자를 알고 있는 경우, 동일한 사용자를 반환합니다.
  • 이전에 알려진 기본 사용자가 로그아웃했고, 장치에 로그인된 사용자가 한 명뿐인 경우, 해당 사용자를 새 “기본” 사용자로 표시하고 반환합니다.
  • 이전에 알려진 기본 사용자가 로그아웃했고, 장치에 로그인된 사용자가 여러 명인 경우, E_GAMEUSER_NO_DEFAULT_USER를 반환합니다.
  • 개발자 실행에서는 자동 로그인 사용자가 기본 사용자가 됩니다. 자동 로그인 사용자는 DevHome에서 해당 사용자를 자동 로그인 사용자로 설정하거나 xbconfig (NDA 항목)의 DefaultUser를 사용하여 지정할 수 있습니다.
기본 사용자를 사용할 수 없는 경우*, XUserAddResult는 E_GAMEUSER_NO_DEFAULT_USER를 반환합니다. XUserAddOptions::AddDefaultUserSilently로 설정되지 않은 optionsXUserAddAsync를 호출해야 합니다. options를 XUserAddOptions::AddDefaultUserAllowingUI로 설정하여 XUserAddAsync를 반복해서 호출하는 경우에도 개발자가 알아야 할 몇 가지 예외적인 상황이 있습니다. 이 상황들은 자동(무음) UI 경우와 매우 유사(동일하지는 않음)합니다.
  • 이 함수를 반복해서 호출할 때 게임을 시작한 기본 사용자를 알고 있는 경우, 동일한 사용자를 반환합니다.
  • 이전에 알려진 기본 사용자가 로그아웃했고, 장치에 로그인된 사용자가 한 명뿐인 경우, 해당 사용자를 새 “기본” 사용자로 표시하고 반환합니다.
  • 처음 게임을 시작한 사용자가 로그아웃했고, 사용자 수가 0명이거나 두 명 이상인 경우, 시스템이 UI를 표시하여 사용자를 가져오고 해당 사용자를 기본 사용자로 설정합니다.
XUserAddAsync에서는 XUserAddOptions::AllowGuests를 XUserAddOptions::AddDefaultUserSilently와 함께 사용할 수 없습니다. 게스트는 기본 사용자가 될 수 없습니다. 현재 플랫폼이 게스트를 지원하지 않더라도 XUserAddOptions::AllowGuests를 사용할 수 있습니다. 다음 예제는 게임 세션에 사용자를 비동기적으로 추가하는 방법을 보여줍니다.

요구 사항

헤더: XUser.h 지원되는 플랫폼: Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔

함께 보기

XUser XUserAddAsync XUserAddResult
마지막 수정일 2026년 8월 24일