XUser

XUser API 的参考资料。

函数

函数 说明
XUserAddAsync 将用户异步添加到游戏会话。
XUserAddByIdWithUiAsync 基于游戏邀请中的 XUID 将用户异步添加到游戏会话。 此函数应仅用于响应游戏邀请。
XUserAddByIdWithUiResult 检索 XUserAddByIdWithUiAsync 创建的用户的句柄。 此函数仅适用于对游戏邀请的响应。
XUserAddResult 检索 XUserAddAsync 创建的用户的句柄。
XUserChangeEventCallback 应用程序为用户更改事件定义的回调。
XUserCheckPrivilege 确定用户是否具有特定权限。
XUserCloseHandle 关闭特定用户句柄。
XUserCloseSignOutDeferralHandle 关闭特定的用户注销延迟句柄。
XUserCompare 比较两个用户句柄是否相等。
XUserDefaultAudioEndpointUtf16ChangedCallback 用户的默认音频终结点更改时,应用程序定义和调用的回调。
XUserDeviceAssociationChangedCallback 用户-设备关联更改时调用的回调。
XUserDuplicateHandle 复制用户句柄。
XUserFindControllerForUserWithUiAsync 显示提示用户打开并标识要使用控制器的对话框。
XUserFindControllerForUserWithUiResult 检索用户选择使用的应用程序本地设备 ID (APP_LOCAL_DEVICE_ID)。
XUserFindForDevice 检索特定设备 ID 的用户 ID。
XUserFindUserById 检索本地用户的 XBox 用户 ID (XUID)。
XUserFindUserByLocalId 检索特定本地用户 ID 的用户句柄。
XUserGetAgeGroup 返回用户的年龄组。
XUserGetDefaultAudioEndpointUtf16 检索特定用户的默认音频终结点。
XUserGetGamerPictureAsync 异步检索特定用户的玩家图片。
XUserGetGamerPictureResult 检索调用 XUserGetGamerPictureAsync 的结果。
XUserGetGamerPictureResultSize 返回 XUserGetGamerPictureResult 检索 ]XUserGetGamerPictureAsync](functions/xusergetgamerpictureasync.md) 返回的玩家图片所需的缓冲区大小。
XUserGetGamertag 检索特定用户的玩家代号。
XUserGetId 获取特定用户的用户 ID。
XUserGetIsGuest 返回一个指示用户是否是访客的布尔值。
XUserGetLocalId 检索用户的唯一游戏会话 ID。
XUserGetMaxUsers 检索游戏会话在当前平台上允许的最大用户数。
XUserGetMsaTokenSilentlyAsync 异步检索用户 MSA 令牌。
XUserGetMsaTokenSilentlyResult 获取调用 XUserGetMsaTokenSilentlyAsync 的结果。
XUserGetMsaTokenSilentlyResultSize 获取用于保存对 XUserGetMsaTokenSilentlyAsync 调用结果的缓冲区大小。
XUserGetSignOutDeferral 检索注销延迟的句柄。
XUserGetState 检索用户的状态。
XUserGetTokenAndSignatureAsync 异步检索 Web 请求的 xtoken 和签名。
XUserGetTokenAndSignatureResult 获取调用 XUserGetTokenAndSignatureAsync 的结果。
XUserGetTokenAndSignatureResultSize 获取用于存放调用 XUserGetTokenAndSignatureAsync 的结果的缓冲区大小。
XUserGetTokenAndSignatureUtf16Async 异步检索 Web 请求的 Unicode xtoken 和签名。
XUserGetTokenAndSignatureUtf16Result 获取调用 XUserGetTokenAndSignatureUtf16Async 的结果。
XUserGetTokenAndSignatureUtf16ResultSize 获取用于存放调用 XUserGetTokenAndSignatureUtf16Async 的结果的缓冲区大小。
XUserIsStoreUser 检查 XUser MSA 是否与登录到 Microsoft Store 的 MSA 相同。
XUserRegisterForChangeEvent 注册用户更改事件的回调。
XUserRegisterForDefaultAudioEndpointUtf16Changed 注册在默认音频终结点更改时应用程序定义和调用的回调。
XUserRegisterForDeviceAssociationChanged 为用户设备关联更改事件注册回调。
XUserResolveIssueWithUiAsync 显示用于使用非 Unicode URL 解决令牌问题的系统用户界面。
XUserResolveIssueWithUiResult 检索调用 XUserResolveIssueWithUiAsync 的结果。
XUserResolveIssueWithUiUtf16Async 显示用于使用特定 Unicode URL 解决令牌问题的系统用户界面。
XUserResolveIssueWithUiUtf16Result 检索调用 XUserResolveIssueWithUiUtf16Async 的结果。
XUserResolvePrivilegeWithUiAsync 显示所需的用户权限的解决用户界面。
XUserResolvePrivilegeWithUiResult 检索调用 XUserResolvePrivilegeWithUiAsync 的结果。
XUserUnregisterForChangeEvent 取消注册以前注册的用户更改回调。
XUserUnregisterForDefaultAudioEndpointUtf16Changed 取消注册以前注册的默认音频终结点更改回调。
XUserUnregisterForDeviceAssociationChanged 取消注册以前注册的用户设备关联更改回调。

结构

结构 说明
APP_LOCAL_DEVICE_ID 指定本地输入设备的根 ID。
XUserDeviceAssociationChange 指定设备关联更改时旧设备和新设备的关联。
XUserGetTokenAndSignatureData 指定我们为 Web 请求检索的 xtoken 和签名。
XUserGetTokenAndSignatureHttpHeader 指定 Web 请求的 HTTP 标头。
XUserGetTokenAndSignatureUtf16Data 包含 Web 请求的 Unicode xtoken 和签名。
XUserGetTokenAndSignatureUtf16HttpHeader 包含 Web 请求的 Unicode HTTP 标头。
XUserLocalId 指定用户的游戏会话 ID。

枚举

枚举 说明
XUserAddOptions 指定用于添加用户的选项。
XUserAgeGroup 指定用户的年龄组。
XUserChangeEvent 指定用户更改事件的类型。
XUserDefaultAudioEndpointKind 指定是否使用用户的默认音频终结点呈现或捕获音频。
XUserGamerPictureSize 指定玩家图片的大小(像素)。
XUserGamertagComponent 指定要获取的玩家代号的类型(或组件)。
XUserGetMsaTokenSilentlyOptions XUserGetMsaTokenSilentlyOptions 的选项。
XUserGetTokenAndSignatureOptions GetUserTokenAndSignatureAsync 的选项。
XUserPrivilege 指定用户的权限。
XUserPrivilegeDenyReason 指定用户无法获取权限的原因。
XUserPrivilegeOptions 指定用户权限选项。
XUserState 指定用户的当前状态。

另请参阅

系统 API 参考