XUser
XUser API 的参考资料。函数
结构
| 结构 | 描述 |
|---|---|
| APP_LOCAL_DEVICE_ID | 指定本地输入设备的根 ID。 |
| XUserDeviceAssociationChange | 指定当设备关联发生更改时旧的和新的设备关联。 |
| XUserGetTokenAndSignatureData | 指定为 Web 请求所检索的 xtoken 和签名。 |
| XUserGetTokenAndSignatureHttpHeader | 指定 Web 请求的 HTTP 标头。 |
| XUserGetTokenAndSignatureUtf16Data | 包含 Web 请求的 Unicode xtoken 和签名。 |
| XUserGetTokenAndSignatureUtf16HttpHeader | 包含 Web 请求的 Unicode HTTP 标头。 |
| XUserLocalId | 指定用户的游戏会话 ID。 |
| XUserPlatformRemoteConnectEventHandlers | 封装远程连接事件处理程序 |
枚举
| 枚举 | 描述 |
|---|---|
| XUserAddOptions | 指定用于添加用户的选项。 |
| XUserAgeGroup | 指定用户的年龄组。 |
| XUserChangeEvent | 指定用户更改事件的类型。 |
| XUserDefaultAudioEndpointKind | 指定用户的默认音频终结点用于呈现还是捕获音频。 |
| XUserGamerPictureSize | 指定玩家图片的大小（以像素为单位）。 |
| XUserGamertagComponent | 指定要获取的玩家代号的类型（或组件）。 |
| XUserGetMsaTokenSilentlyOptions | XUserGetMsaTokenSilentlyOptions 的选项。 |
| XUserGetTokenAndSignatureOptions | GetUserTokenAndSignatureAsync 的选项。 |
| XUserPrivilege | 指定用户的权限。 |
| XUserPrivilegeDenyReason | 指定用户无法获得权限的原因。 |
| XUserPrivilegeOptions | 指定用户权限选项。 |
| XUserState | 指定用户的当前状态。 |
| XUserPlatformOperationResult | 定义客户端操作结果的枚举 |
| XUserPlatformSpopOperationResult | 定义客户端操作结果的枚举。 |
概念文档
另请参阅
系统 API 参考错误代码
XUser API 可能返回以下错误代码。有关完整列表，请参阅错误代码。| 代码 | 值 | 描述 |
|---|---|---|
| E_GAMEUSER_MAX_USERS_ADDED | 0x89245100 | 无法添加此用户，因为已达到最大用户数量。 |
| E_GAMEUSER_SIGNED_OUT | 0x89245101 | 由于用户已注销，无法执行该操作。 |
| E_GAMEUSER_RESOLVE_USER_ISSUE_REQUIRED | 0x89245102 | 需要 UI 来解决此用户的问题。 |
| E_GAMEUSER_DEFERRAL_NOT_AVAILABLE | 0x89245103 | 现在请求延迟不合适。 |
| E_GAMEUSER_USER_NOT_FOUND | 0x89245104 | 未找到与该 ID 匹配的用户。 |
| E_GAMEUSER_NO_TOKEN_REQUIRED | 0x89245105 | 此调用不需要令牌。 |
| E_GAMEUSER_NO_DEFAULT_USER | 0x89245106 | 没有当前默认用户。如果收到此错误，请在不带 AddDefaultUserSilently 的情况下再次调用 XUserAddAsync。 |
| E_GAMEUSER_FAILED_TO_RESOLVE | 0x89245107 | 未能解决给定的权限。 |
| E_GAMEUSER_NO_TITLE_ID | 0x89245108 | 必须配置 XBOX Live TitleId。 |
| E_GAMEUSER_UNKNOWN_GAME_IDENTITY | 0x89245109 | 无法识别游戏身份。MSAAppId 和 TitleId 与与该游戏关联的不匹配。 |
| E_GAMEUSER_NO_PACKAGE_IDENTITY | 0x89245110 | 必须配置程序包身份。 |
| E_GAMEUSER_FAILED_TO_GET_TOKEN | 0x89245111 | 令牌请求失败。 |
| E_GAMEUSER_INVALID_APP_CONFIGURATION | 0x89245112 | 游戏配置中的 MSAAppId 无效或未针对身份验证堆栈进行配置。 |
| E_GAMEUSER_MALFORMED_MSAAPPID | 0x89245113 | 游戏配置中的 MSAAppId 与预期格式不匹配（16 字符字符串或 GUID）。 |
| E_GAMEUSER_INCONSISTENT_MSAAPPID_AND_TITLEID | 0x89245114 | 游戏配置中的 MSAAppId 和 TitleId 与与该游戏关联的不匹配。 |