Skip to main content

XUserAddResult

擷取 XUserAddAsync 所建立之使用者的控制代碼。

語法

參數

async   _Inout_
類型:XAsyncBlock*
傳送給 XUserAddAsync 的非同步區塊。 newUser   _Out_
類型:XUserHandle*
包含新使用者的控制代碼。

傳回值

類型:HRESULT HRESULT 成功或錯誤碼。

備註

XUserAddAsync 會啟動非同步作業,將使用者新增至遊戲。請使用 XUserAddResult 來擷取作業的結果。 除非您將 XUserAddOptions::AddDefaultUserSilently 傳遞給 options 參數,否則 XUserAddAsync 一律會顯示帳戶選擇器 UI。 如果您使用 XUserAddOptions::AddDefaultUserSilently,XUserAddAsync 不會顯示 UI。XUserAddOptions::AddDefaultUserSilently 傳回的使用者會持續傳回,直到該使用者 登出為止。如果沒有可用的預設使用者,XUserAddResult 會傳回 E_GAMEUSER_NO_DEFAULT_USER。這表示您必須在不使用 XUserAddOptions::AddDefaultUserSilently 的情況下呼叫 XUserAddAsync 來選取使用者。 如果使用者遭到 XBOX Live 封鎖,遊戲將無法取得該使用者的 XUserHandle。 如果使用了 XUserAddOptions::AddDefaultUserSilently,且遊戲是由遭封鎖的使用者啟動, XUserAddResult 會傳回 E_GAMEUSER_NO_DEFAULT_USER。否則,如果顯示了 UI,則必須由未遭封鎖的 使用者登入,或使用者必須取消 UI,此時 XUserAddResult 會 傳回 E_ABORT。 您無法將 XUserAddOptions::AllowGuests 與 XUserAddOptions::AddDefaultUserSilently 一起使用。來賓 不能是預設使用者。無論目前的平台是否支援來賓,您都可以放心使用 XUserAddOptions::AllowGuests。 您從 XUsers API 擷取的每個 XUserHandle 控制代碼,都必須呼叫 XUserCloseHandle 關閉一次。 下列範例示範如何以非同步方式將使用者新增至遊戲工作階段。

需求

標頭: XUser.h 程式庫: xgameruntime.lib 支援的平台: Windows、Steam Deck、XBOX One 系列主機和 XBOX Series 主機

概念文件

另請參閱

XUser XUserAddAsync XUserAddOptions XUserCloseHandle
Last modified on October 6, 2026