Skip to main content

XUserAddByIdWithUiAsync

게임 초대의 XUID를 기반으로 게임 세션에 사용자를 비동기적으로 추가합니다. 이 함수는 게임 초대에 대한 응답으로만 사용해야 합니다.

구문

매개변수

userId   _In_
형식: uint64_t
추가할 사용자의 XUID입니다. 이 XUID는 XGameInviteRegisterForEvent로 등록된 게임 콜백에서 수신된 inviteUri를 파싱하여 얻어야 합니다. async   _Inout_
형식: XAsyncBlock*
호출의 상태를 폴링하고 호출 결과를 가져오기 위한 XAsyncBlock입니다.

반환값

형식: HRESULT HRESULT 성공 또는 오류 코드입니다. 오류 코드 목록은 Error Codes를 참조하십시오.

설명

XUserAddByIdWithUiAsync는 게임에 사용자를 추가하는 비동기 작업을 시작합니다. 작업 결과를 가져오려면 XUserAddByIdWithUiResult를 사용합니다. 게임 초대를 처리할 때, 콘솔에서는 게임 초대에 지정된 사람의 XUID가 게임에 이미 로그인되어 있는 사람이 아닐 가능성이 항상 있습니다. XUserAddByIdWithUiAsync를 사용하면 게임이 초대 URI에서 파싱된 XUID를 사용하여 해당 사용자를 추가할 수 있습니다. 이 함수는 UI를 표시하지 않고 사용자를 추가하려고 시도합니다. UI가 표시될 수 있는 유일한 이유는 사용자가 토큰과 관련된 문제를 해결해야 하기 때문입니다. 콘솔에서는 UI 표시가 드물어야 합니다. 사용자가 장치에 로그인되어 있지 않은 경우, XUserAddByIdWithUiResult는 E_GAMEUSER_USER_NOT_FOUND를 반환합니다. XUsers API에서 가져오는 각 XUserHandle 핸들은 XUserCloseHandle을 호출하여 한 번만 닫아야 합니다. 게임 초대를 받으려면 개발자는 XGameInviteRegisterForEvent를 호출하여 XGameInviteCallback을 구독해야 합니다. 이 콜백이 호출될 때 게임은 반환된 inviteUri를 파싱하여 해당 초대를 받는 사용자의 XUID를 결정해야 합니다. 그 시점에서 게임은 초대를 받는 사람에 대한 XUserHandle을 얻기를 원할 수 있습니다. 다음 코드는 이 방식을 보여줍니다.

요구 사항

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

함께 보기

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