Skip to main content

XUserAddOptions

指定用于添加用户的选项。

Syntax

Constants

Remarks

如果开发者反复调用 XUserAddAsync 并将 options 设置为 XUserAddOptions::AddDefaultUserSilently,则应了解一些边缘情况:
  • 如果反复调用此项,并且我们知道启动游戏的默认用户,它将返回相同的用户。
  • 如果先前已知的默认用户已注销,并且只有一个用户登录设备,它会将该用户标记为新的“默认”用户并返回。
  • 如果先前已知的默认用户已注销,并且有多个用户登录设备,它将返回 E_GAMEUSER_NO_DEFAULT_USER。
  • 在开发者启动中,将作为默认用户的用户是自动登录用户,可通过在 DevHome 中将该用户设置为自动登录用户,或者通过使用 xbconfig(NDA 主题) DefaultUser 来指定。
如果默认用户不可用*,XUserAddResult 将返回 E_GAMEUSER_NO_DEFAULT_USER。必须调用 XUserAddAsync,并且 options 不设置为 XUserAddOptions::AddDefaultUserSilently。 如果开发者反复调用 XUserAddAsync 并将 options 设置为 XUserAddOptions::AddDefaultUserAllowingUI,也应了解一些边缘情况。这些情况与静默 UI 情况非常相似(但不完全相同):
  • 如果反复调用此项,并且我们知道启动游戏的默认用户,它将返回相同的用户。
  • 如果先前已知的默认用户已注销,并且只有一个用户登录设备,它会将该用户标记为新的“默认”用户并返回。
  • 如果最初启动游戏的用户已注销,并且用户数为 0 或多于 1,则系统将显示 UI 以获取用户,然后将该用户设置为默认。
XUserAddAsync 中,不能将 XUserAddOptions::AllowGuests 与 XUserAddOptions::AddDefaultUserSilently 一起使用。来宾不能是默认用户。 即使当前平台不支持来宾,也可以使用 XUserAddOptions::AllowGuests。 以下示例演示了如何异步地将用户添加到游戏会话。

Requirements

头文件: XUser.h 受支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机

See also

XUser XUserAddAsync XUserAddResult
最后修改于 2026年8月24日