Skip to main content

XUserAddOptions

指定新增使用者的選項。

語法

常數

備註

如果開發人員以設定為 XUserAddOptions::AddDefaultUserSilently 的 options 重複呼叫 XUserAddAsync,應該了解一些邊緣案例:
  • 如果您重複呼叫此函式,且我們知道啟動遊戲的預設使用者,則會傳回同一位使用者。
  • 如果先前已知的預設使用者已登出,且裝置上只有一位已登入的使用者,則會 將該使用者標示為新的「預設」使用者並傳回該使用者。
  • 如果先前已知的預設使用者已登出,且裝置上有多位已登入的使用者,則 會傳回 E_GAMEUSER_NO_DEFAULT_USER。
  • 在開發人員啟動中,預設使用者是自動登入使用者,您可以在 DevHome 中將該使用者設定為自動登入使用者,或使用 xbconfig (NDA 主題) DefaultUser 來指定。
如果沒有可用的預設使用者*,XUserAddResult 會傳回 E_GAMEUSER_NO_DEFAULT_USER。您必須以未設定為 XUserAddOptions::AddDefaultUserSilently 的 options 呼叫 XUserAddAsync。 如果開發人員以設定為 XUserAddOptions::AddDefaultUserAllowingUI 的 options 重複呼叫 XUserAddAsync,也應該了解一些邊緣案例。這些案例與無訊息 UI 的情況 非常類似 (但不完全相同):
  • 如果您重複呼叫此函式,且我們知道啟動遊戲的預設使用者,則會傳回同一位使用者。
  • 如果先前已知的預設使用者已登出,且裝置上只有一位已登入的使用者,則會 將該使用者標示為新的「預設」使用者並傳回該使用者。
  • 如果最初啟動遊戲的使用者已登出,且使用者數目為 0 或超過 1 位, 系統會顯示 UI 以取得使用者,然後將該使用者設定為預設使用者。
在 XUserAddAsync 中,您無法將 XUserAddOptions::AllowGuests 與 XUserAddOptions::AddDefaultUserSilently 一起使用。來賓不能是預設使用者。 即使目前的平台不支援來賓,您仍可使用 XUserAddOptions::AllowGuests。 下列範例示範如何以非同步方式將使用者新增至遊戲工作階段。

需求

標頭: XUser.h 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

另請參閱

XUser XUserAddAsync XUserAddResult
Last modified on October 6, 2026