Skip to main content

XUserAddResult

XUserAddAsync가 만든 사용자에 대한 핸들을 가져옵니다.

구문

매개변수

async   _Inout_
형식: XAsyncBlock*
XUserAddAsync에 전달된 async 블록입니다. newUser   _Out_
형식: XUserHandle*
새 사용자에 대한 핸들을 포함합니다.

반환값

형식: HRESULT HRESULT 성공 또는 오류 코드입니다.

설명

XUserAddAsync는 게임에 사용자를 추가하는 비동기 작업을 시작합니다. 작업 결과를 가져오려면 XUserAddResult를 사용합니다. XUserAddAsyncXUserAddOptions::AddDefaultUserSilentlyoptions 매개변수에 전달하지 않는 한 항상 계정 선택 UI를 표시합니다. XUserAddOptions::AddDefaultUserSilently를 사용하는 경우, XUserAddAsync는 UI를 표시하지 않습니다. XUserAddOptions::AddDefaultUserSilently가 반환한 사용자는 사용자가 로그아웃할 때까지 계속 반환됩니다. 기본 사용자를 사용할 수 없는 경우, XUserAddResultE_GAMEUSER_NO_DEFAULT_USER를 반환합니다. 이는 사용자를 선택하기 위해 XUserAddOptions::AddDefaultUserSilently 없이 XUserAddAsync를 호출해야 함을 나타냅니다. 사용자가 XBOX Live에서 금지된 경우, 게임은 해당 사용자에 대한 XUserHandle을 얻을 수 없습니다. XUserAddOptions::AddDefaultUserSilently가 사용되었고 게임이 금지된 사용자에 의해 시작된 경우, XUserAddResult는 E_GAMEUSER_NO_DEFAULT_USER를 반환합니다. 그렇지 않은 경우 UI가 표시되면 금지되지 않은 사용자가 로그인해야 하거나 사용자가 UI를 취소해야 하며 XUserAddResult는 E_ABORT를 반환합니다. XUserAddOptions::AllowGuestsXUserAddOptions::AddDefaultUserSilently와 함께 사용할 수 없습니다. 게스트는 기본 사용자가 될 수 없습니다. 현재 플랫폼이 게스트를 지원하는지 여부와 관계없이 XUserAddOptions::AllowGuests를 안전하게 사용할 수 있습니다. XUsers API에서 가져오는 각 XUserHandle 핸들은 XUserCloseHandle을 호출하여 한 번 닫아야 합니다. 다음 예제는 게임 세션에 사용자를 비동기적으로 추가하는 방법을 보여줍니다.

요구 사항

헤더: XUser.h 라이브러리: xgameruntime.lib 지원되는 플랫폼: Windows, Steam Deck, XBOX One 계열 콘솔 및 XBOX Series 콘솔

개념 문서

함께 보기

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