HRESULT 值递增排序，方便按数值查找。
有关工具和平台 HRESULT 的全面覆盖信息（包括启动、部署和诊断工具场景），请参阅 错误查找 (xberror.exe)。
游戏运行时
| 代码 | 值 | 说明 | 来源 | 故障排除 |
|---|---|---|---|---|
| E_GAME_MISSING_GAME_CONFIG | 0x87E5001F | 此应用缺少必需的 MicrosoftGame.Config 文件。 | MicrosoftGame.config 元素参考 | 向包中添加有效的 MicrosoftGame.config 文件，然后重新生成/重新部署。 |
| E_GAMERUNTIME_NOT_INITIALIZED | 0x89240100 | 游戏运行时未初始化。 | XGameRuntime | 在重试之前，验证运行时的 init/uninit 顺序、包兼容性以及应用状态。 |
| E_GAMERUNTIME_DLL_NOT_FOUND | 0x89240101 | 未找到游戏运行时 DLL。 | XGameRuntime | 在重试之前，验证运行时的 init/uninit 顺序、包兼容性以及应用状态。 |
| E_GAMERUNTIME_VERSION_MISMATCH | 0x89240102 | 游戏运行时 DLL 不支持此版本的 GDK。 | XGameRuntime | 在重试之前，验证运行时的 init/uninit 顺序、包兼容性以及应用状态。 |
| E_GAMERUNTIME_WINDOW_NOT_FOREGROUND | 0x89240103 | 此操作需要应用窗口位于前台。 | 将应用窗口置于前台，然后重试该操作。 | |
| E_GAMERUNTIME_SUSPENDED | 0x89240104 | 游戏运行时处于挂起状态。 | XBOX 游戏生命周期 | 在重试之前，验证运行时的 init/uninit 顺序、包兼容性以及应用状态。 |
| E_GAMERUNTIME_UNINITIALIZE_ACTIVEOBJECTS | 0x89240105 | 在 XGameRuntimeUninitialize 时游戏运行时存在活动对象。 | XGameRuntimeUninitialize | 在重试之前，验证运行时的 init/uninit 顺序、包兼容性以及应用状态。 |
| E_GAMERUNTIME_MULTIPLAYER_NOT_CONFIGURED | 0x89240106 | 服务上未为此用户在此标题设置多人游戏活动。 | XBOX 服务多人游戏 | 在重试之前，验证运行时的 init/uninit 顺序、包兼容性以及应用状态。 |
| E_GAMERUNTIME_OPTIONS_MISMATCH | 0x89240109 | 运行时已使用一组不同的选项进行初始化。请先执行 Uninitialize，然后再使用新选项重新初始化。 | XGameRuntimeUninitialize | 在重试之前，验证运行时的 init/uninit 顺序、包兼容性以及应用状态。 |
| E_GAMERUNTIME_OPTIONS_NOT_SUPPORTED | 0x8924010A | 传入的选项与游戏包不兼容。游戏配置信息必须与包相匹配。 | MicrosoftGame.config 元素参考 | 在重试之前，验证运行时的 init/uninit 顺序、包兼容性以及应用状态。 |
| E_GAMERUNTIME_GAMECONFIG_BAD_FORMAT | 0x8924010B | 传递给 Initialize 的游戏配置无法解析。 | MicrosoftGame.config 元素参考 | 在重试之前，验证运行时的 init/uninit 顺序、包兼容性以及应用状态。 |
| E_GAMERUNTIME_INVALID_HANDLE | 0x8924010C | 句柄在跨运行时初始化时无法使用。 | 在重试之前，验证运行时的 init/uninit 顺序、包兼容性以及应用状态。 |
游戏用户
| 代码 | 值 | 说明 | 来源 | 故障排除 |
|---|---|---|---|---|
| E_GAMEUSER_MAX_USERS_ADDED | 0x89245100 | 无法添加此用户，因为已达到最大用户数量。 | XUserAddAsync | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E_GAMEUSER_SIGNED_OUT | 0x89245101 | 无法执行操作，因为该用户已注销。 | XUserAddAsync | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E_GAMEUSER_RESOLVE_USER_ISSUE_REQUIRED | 0x89245102 | 需要 UI 来解决此用户的问题。 | XUserResolveIssueWithUiAsync | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E_GAMEUSER_DEFERRAL_NOT_AVAILABLE | 0x89245103 | 此时不宜请求延迟。 | XUserGetTokenAndSignatureAsync | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E_GAMEUSER_USER_NOT_FOUND | 0x89245104 | 找不到与该 ID 匹配的用户。 | 验证登录/默认用户/标题标识配置，然后重试用户流程。 | |
| E_GAMEUSER_NO_TOKEN_REQUIRED | 0x89245105 | 此调用不需要令牌。 | 验证登录/默认用户/标题标识配置，然后重试用户流程。 | |
| E_GAMEUSER_NO_DEFAULT_USER | 0x89245106 | 当前没有默认用户。如果收到此错误，请在不使用 AddDefaultUserSilently 的情况下再次调用 XUserAddAsync。 | XUserAddAsync | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E_GAMEUSER_FAILED_TO_RESOLVE | 0x89245107 | 无法解析给定的特权。 | 验证登录/默认用户/标题标识配置，然后重试用户流程。 | |
| E_GAMEUSER_NO_TITLE_ID | 0x89245108 | 必须配置 XBOX Live TitleId。 | MicrosoftGame.config 元素参考 | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E_GAMEUSER_UNKNOWN_GAME_IDENTITY | 0x89245109 | 游戏标识未被识别。MSAAppId 和 TitleId 与游戏关联的不匹配。 | MicrosoftGame.config 元素参考 | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E_GAMEUSER_NO_PACKAGE_IDENTITY | 0x89245110 | 必须配置包标识。 | 合作伙伴中心初始配置 | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E_GAMEUSER_FAILED_TO_GET_TOKEN | 0x89245111 | 令牌请求失败。 | 验证登录/默认用户/标题标识配置，然后重试用户流程。 | |
| E_GAMEUSER_INVALID_APP_CONFIGURATION | 0x89245112 | 游戏配置中的 MSAAppId 无效或未针对身份验证堆栈进行配置。 | MicrosoftGame.config 元素参考 | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E_GAMEUSER_MALFORMED_MSAAPPID | 0x89245113 | 游戏配置中的 MSAAppId 与预期格式不匹配（16 字符字符串或 GUID）。 | 验证登录/默认用户/标题标识配置，然后重试用户流程。 | |
| E_GAMEUSER_INCONSISTENT_MSAAPPID_AND_TITLEID | 0x89245114 | 游戏配置中的 MSAAppId 和 TitleId 与游戏关联的不匹配。 | MicrosoftGame.config 元素参考 | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
游戏包
| 代码 | 值 | 说明 | 来源 | 故障排除 |
|---|---|---|---|---|
| E_GAMEPACKAGE_APP_NOT_PACKAGED | 0x89245200 | 游戏未打包到容器中。 | 验证包安装/内容状态，并在重新部署所需资源后重试。 | |
| E_GAMEPACKAGE_NO_INSTALLED_LANGUAGES | 0x89245201 | 游戏使用智能分发有选择地安装语言，但未安装任何语言。 | Intelligent Delivery 语言 | 验证包安装/内容状态，并在重新部署所需资源后重试。 |
| E_GAMEPACKAGE_NO_STORE_ID | 0x89245202 | 必须在应用的游戏配置中设置 StoreId 属性。 | MicrosoftGame.config 元素参考 | 验证包安装/内容状态，并在重新部署所需资源后重试。 |
| E_GAMEPACKAGE_INVALID_SELECTOR | 0x89245203 | 提供的区块选择器无法解析为包中的区块。 | Chunk 元素参考 | 验证包安装/内容状态，并在重新部署所需资源后重试。 |
| E_GAMEPACKAGE_DOWNLOAD_REQUIRED | 0x89245204 | 必须下载一个或多个所需的区块，才能在此设备上装载该包。 | 验证包安装/内容状态，并在重新部署所需资源后重试。 | |
| E_GAMEPACKAGE_NO_TAG_CHANGE | 0x89245205 | 请使用 Features 而非 tags 更改此包中已安装的区块。 | Intelligent Delivery recipes | 验证包安装/内容状态，并在重新部署所需资源后重试。 |
| E_GAMEPACKAGE_DLC_NOT_SUPPORTED | 0x89245206 | 游戏不支持该 DLC 包。请确保游戏配置中的 DLC 兼容性正确。 | MicrosoftGame.config 元素参考 | 验证包安装/内容状态，并在重新部署所需资源后重试。 |
| E_GAMEPACKAGE_DUPLICATE_ID_VALUES | 0x89245207 | 包中包含多个映射到相同 ‘ID’ 属性的可执行文件。请检查 ‘Executable’ 元素中是否存在重复的 ‘ID’ 属性。 | MicrosoftGame.config 元素参考 | 验证包安装/内容状态，并在重新部署所需资源后重试。 |
| E_GAMEPACKAGE_NO_PACKAGE_IDENTIFIER | 0x89245208 | 无法解析包的标识符。该包可能未安装。 | 验证包安装/内容状态，并在重新部署所需资源后重试。 | |
| E_GAMEPACKAGE_CONFIG_NO_ROOT_NODE | 0x89245209 | 在 MicrosoftGame.config 文件中找不到根 Game 节点。请检查该文件格式是否正确。 | MicrosoftGame.config 元素参考 | 更正 MicrosoftGame.config 架构/值，然后重新生成/重新部署包。 |
| E_GAMEPACKAGE_CONFIG_ZERO_VERSION | 0x8924520A | MicrosoftGame.config 中 ‘Identity’ 节点的 ‘Version’ 属性不能为 0.0.0.0。请递增或移除此属性。如果未指定版本，则默认为 1.0.0.0。 | 更正 MicrosoftGame.config 架构/值，然后重新生成/重新部署包。 | |
| E_GAMEPACKAGE_CONFIG_NO_MSAAPPID_NOTITLEID | 0x8924520B | MicrosoftGame.config 中缺少 ‘MSAAppId’ 或 ‘TitleId’ 元素。当 configVersion >= 1 时，必须同时指定这两者。 | MicrosoftGame.config 元素参考 | 更正 MicrosoftGame.config 架构/值，然后重新生成/重新部署包。 |
| E_GAMEPACKAGE_CONFIG_DEPRECATED_PC_ENTRIES | 0x8924520C | 在 configVersion >= 1 中，DesktopRegistration 条目 “modFolder”、“enableWritesToPackageRoot”、“disableRegistryWriteVirtualization” 和 “disableFilesystemWriteVirtualization” 已弃用。 | 更正 MicrosoftGame.config 架构/值，然后重新生成/重新部署包。 | |
| E_GAMEPACKAGE_CONFIG_SUM_REQUIRES_MSAAPPID | 0x8924520D | 当使用简化用户模型（AdvancedUserModel 元素）且 configVersion >= 1 时，必须提供 ‘MSAAppId’ 和 ‘TitleId’ 元素。 | MicrosoftGame.config 元素参考 | 更正 MicrosoftGame.config 架构/值，然后重新生成/重新部署包。 |
| E_GAMEPACKAGE_CONFIG_NO_CODE_CLOUD_SAVES_REQUIRES_MSAAPPID | 0x8924520E | 当使用无代码云保存（NoCodePCRoot 元素）且 configVersion >= 1 时，必须提供 ‘MSAAppId’ 和 ‘TitleId’ 元素。 | MicrosoftGame.config 元素参考 | 更正 MicrosoftGame.config 架构/值，然后重新生成/重新部署包。 |
| E_GAMEPACKAGE_CONFIG_MSAAPPID_OR_TITLEID_IS_DEFAULT | 0x8924520F | ’MSAAppId’ 或 ‘TitleId’ 元素为默认值。如果指定了 NoCodePCRoot 或 AdvancedUserModel，则在使用 configVersion >= 1 时，TitleId 和 MSAAppId 都必须是来自合作伙伴中心的有效 ID。 | MicrosoftGame.config 元素参考 | 更正 MicrosoftGame.config 架构/值，然后重新生成/重新部署包。 |
游戏商店
| 代码 | 值 | 说明 | 来源 | 故障排除 |
|---|---|---|---|---|
| E_GAMESTORE_LICENSE_ACTION_NOT_APPLICABLE_TO_PRODUCT | 0x89245300 | 游戏为无法授权的产品请求了许可。 | XStore 概述 | 验证商店连接性、权益/许可证状态，然后重试请求。 |
| E_GAMESTORE_NETWORK_ERROR | 0x89245301 | 游戏无法与商店网络通信。 | XStore 概述 | 验证商店连接性、权益/许可证状态，然后重试请求。 |
| E_GAMESTORE_SERVER_ERROR | 0x89245302 | 游戏从商店服务器收到了错误的响应。 | XStore 概述 | 验证商店连接性、权益/许可证状态，然后重试请求。 |
| E_GAMESTORE_INSUFFICIENT_QUANTITY | 0x89245303 | 用户所拥有的此消耗品数量不足以使用所请求的数量。 | XStore 概述 | 验证商店连接性、权益/许可证状态，然后重试请求。 |
| E_GAMESTORE_ALREADY_PURCHASED | 0x89245304 | 用户已拥有此产品。 | XStore 概述 | 验证商店连接性、权益/许可证状态，然后重试请求。 |
| E_GAMESTORE_LICENSE_ACTION_THROTTLED | 0x89245305 | 游戏对该产品的许可查询过于频繁，现已被限流。同一产品在 10 分钟内的许可尝试次数上限为 30 次。 | XStore 概述 | 验证商店连接性、权益/许可证状态，然后重试请求。 |
游戏流式传输
| 代码 | 值 | 说明 | 来源 | 故障排除 |
|---|---|---|---|---|
| E_GAMESTREAMING_NOT_INITIALIZED | 0x89245400 | XGameStreaming 运行时未初始化。请在调用其他 API 之前调用 XGameStreamingInitialize。 | XGameStreamingInitialize | 确保流式传输已初始化且客户端/会话上下文有效，然后重试。 |
| E_GAMESTREAMING_CLIENT_NOT_CONNECTED | 0x89245401 | 指定的客户端未连接。 | 确保流式传输已初始化且客户端/会话上下文有效，然后重试。 | |
| E_GAMESTREAMING_NO_DATA | 0x89245402 | 请求的数据不可用。数据稍后可能可用。 | 确保流式传输已初始化且客户端/会话上下文有效，然后重试。 | |
| E_GAMESTREAMING_NO_DATACENTER | 0x89245403 | 当前计算机未在数据中心中运行。 | 确保流式传输已初始化且客户端/会话上下文有效，然后重试。 | |
| E_GAMESTREAMING_NOT_STREAMING_CONTROLLER | 0x89245404 | 当前读数并非来自流式传输控制器。 | 确保流式传输已初始化且客户端/会话上下文有效，然后重试。 |
游戏保存
| 代码 | 值 | 说明 | 来源 | 故障排除 |
|---|---|---|---|---|
| E_GS_INVALID_CONTAINER_NAME | 0x80830001 | 容器名称无效。有效的容器名称字符包括大小写字母、数字、下划线和正斜杠。 | XGameSave | 有关详细的故障排除指导，请参阅 游戏保存调试。 |
| E_GS_NO_ACCESS | 0x80830002 | 操作失败，因为标题无权访问容器存储空间。请检查 SCID 和 TitleId 是否配置正确。 | XGameSave | 有关详细的故障排除指导，请参阅 游戏保存调试。 |
| E_GS_OUT_OF_LOCAL_STORAGE | 0x80830003 | 设备没有足够的存储容量来保存游戏。 | XGameSave | 有关详细的故障排除指导，请参阅 游戏保存调试。 |
| E_GS_USER_CANCELED | 0x80830004 | 用户取消了游戏存档的下载。 | XGameSave | 有关详细的故障排除指导，请参阅 游戏保存调试。 |
| E_GS_UPDATE_TOO_BIG | 0x80830005 | 存档更新的大小过大。XGameSave 更新的总大小必须小于 GS_MAX_BLOB_SIZE（16 MB）。 | XGameSave | 有关详细的故障排除指导，请参阅 游戏保存调试。 |
| E_GS_QUOTA_EXCEEDED | 0x80830006 | 此用户在该标题的存储配额已超出。 | XGameSave | 有关详细的故障排除指导，请参阅 游戏保存调试。 |
| E_GS_PROVIDED_BUFFER_TOO_SMALL | 0x80830007 | 提供给 API 的缓冲区过小。 | XGameSave | 有关详细的故障排除指导，请参阅 游戏保存调试。 |
| E_GS_BLOB_NOT_FOUND | 0x80830008 | 找不到指定的 blob。 | XGameSave | 有关详细的故障排除指导，请参阅 游戏保存调试。 |
| E_GS_NO_SERVICE_CONFIGURATION | 0x80830009 | 标题未针对连接存储正确配置。请检查 SCID 是否正确，以及标题是否在合作伙伴中心配置。 | XGameSave | 有关详细的故障排除指导，请参阅 游戏保存调试。 |
| E_GS_CONTAINER_NOT_IN_SYNC | 0x8083000A | 容器尚未同步。请确保 XGameSave 容器在提交更新之前已完成同步。 | XGameSave | 有关详细的故障排除指导，请参阅 游戏保存调试。 |
| E_GS_CONTAINER_SYNC_FAILED | 0x8083000B | 容器同步失败。 | XGameSave | 有关详细的故障排除指导，请参阅 游戏保存调试。 |
| E_GS_USER_NOT_REGISTERED_IN_SERVICE | 0x8083000C | 用户的 MSA 尚未成为 XBOX 服务账户。 | XGameSave | 有关详细的故障排除指导，请参阅 游戏保存调试。 |
| E_GS_HANDLE_EXPIRED | 0x8083000D | 函数使用的句柄已过期，必须重新获取。 | XGameSave | 有关详细的故障排除指导，请参阅 游戏保存调试。 |
| E_GS_ASYNC_FUNCTION_REQUIRED | 0x8083000E | 此同步函数正在时间敏感线程上调用，可能导致死锁。请改用异步实现。 | XGameSave | 有关详细的故障排除指导，请参阅 游戏保存调试。 |
| E_GS_PROVIDER_MISMATCH | 0x8083000F | 游戏混合使用了 XGameSave 与 XGameSaveFiles 调用，这是不支持的。 | XGameSave | 有关详细的故障排除指导，请参阅 游戏保存调试。 |
全局
| 代码 | 值 | 说明 | 来源 | 故障排除 |
|---|---|---|---|---|
| S_OK | 0x00000000 | 操作成功完成。 | XBOX Live HRESULT 错误代码（全局） | 无需操作。 |
| E_PENDING | 0x8000000A | 操作已启动但尚未完成。 | XBOX Live HRESULT 错误代码（全局） | 等待完成，然后再次查询异步结果。 |
| E_BOUNDS | 0x8000000B | 提供的索引或范围超出有效边界。 | XBOX Live HRESULT 错误代码（全局） | 在重试之前验证索引和范围边界。 |
| E_NOTIMPL | 0x80004001 | 未实现此功能。 | XBOX Live HRESULT 错误代码（全局） | 请为此平台和运行时使用受支持的 API 路径。 |
| E_NOINTERFACE | 0x80004002 | 请求的接口在此对象上不可用。 | XBOX Live HRESULT 错误代码（全局） | 在查询此接口之前验证接口的可用性/版本。 |
| E_POINTER | 0x80004003 | 必需的指针为空或无效。 | XBOX Live HRESULT 错误代码（全局） | 在调用之前验证所有指针/句柄和对象生存期。 |
| E_ABORT | 0x80004004 | 操作在完成之前被中止。 | XBOX Live HRESULT 错误代码（全局） | 检查取消/关闭状态，稳定后重新运行。 |
| E_FAIL | 0x80004005 | 操作失败，出现未指定的错误。 | XBOX Live HRESULT 错误代码（全局） | 查阅日志中先前的失败信息，并在更正输入/状态后重试。 |
| E_UNEXPECTED | 0x8000FFFF | 发生了意外的内部错误。 | XBOX Live HRESULT 错误代码（全局） | 捕获诊断信息，重启该场景，如可重现则上报。 |
| E_ACCESSDENIED | 0x80070005 | 拒绝访问所请求的资源或操作。 | XBOX Live HRESULT 错误代码（全局） | 验证权限、功能和用户/账户上下文，然后重试。 |
| E_OUTOFMEMORY | 0x8007000E | 由于无法满足内存分配，操作失败。 | XBOX Live HRESULT 错误代码（全局） | 减小内存压力、释放分配后重试。 |
| E_NOT_SUPPORTED | 0x80070032 | 当前上下文不支持此操作。 | XBOX Live HRESULT 错误代码（全局） | 请在当前上下文中使用受支持的操作。 |
| E_INVALIDARG | 0x80070057 | 一个或多个参数无效。 | XBOX Live HRESULT 错误代码（全局） | 在重试之前验证参数值以及必需的组合。 |
| E_NOT_SUFFICIENT_BUFFER | 0x8007007A | 提供的缓冲区对请求的数据来说过小。 | XBOX Live HRESULT 错误代码（全局） | 查询所需大小、调整缓冲区大小后重试。 |
| E_TIME_CRITICAL_THREAD | 0x800701A0 | 不允许在时间关键线程上调用。 | XBOX Live HRESULT 错误代码（全局） | 将此调用移出时间关键线程；可用时请使用异步模式。 |
| E_NO_TASK_QUEUE | 0x800701AB | 未为该操作提供或没有可用的任务队列。 | XBOX Live HRESULT 错误代码（全局） | 在调用此操作之前提供有效的任务队列。 |
HTTP 客户端
| 代码 | 值 | 说明 | 来源 | 故障排除 |
|---|---|---|---|---|
| HTTP_E_STATUS_UNEXPECTED | 0x80190001 | HTTP 客户端遇到意外的协议/状态状况。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP_E_STATUS_UNEXPECTED_SERVER_ERROR | 0x80190005 | 服务器返回了意外的错误状况。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP_E_STATUS_AMBIGUOUS | 0x8019012C | HTTP 响应表示存在多个匹配资源。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP_E_STATUS_MOVED | 0x8019012D | HTTP 重定向指示资源已移动。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP_E_STATUS_REDIRECT | 0x8019012E | 收到 HTTP 重定向响应。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP_E_STATUS_REDIRECT_METHOD | 0x8019012F | 需要更改方法的 HTTP 重定向。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP_E_STATUS_NOT_MODIFIED | 0x80190130 | HTTP 304：自条件请求以来资源未发生变化。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP_E_STATUS_USE_PROXY | 0x80190131 | HTTP 请求必须通过代理发送。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP_E_STATUS_REDIRECT_KEEP_VERB | 0x80190133 | 保留原始方法/动词的 HTTP 重定向。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP_E_STATUS_BAD_REQUEST | 0x80190190 | HTTP 400：请求格式错误或无效。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP_E_STATUS_DENIED | 0x80190191 | HTTP 401：请求未经授权或被拒绝。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP_E_STATUS_PAYMENT_REQ | 0x80190192 | HTTP 402：此请求需要付款。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP_E_STATUS_FORBIDDEN | 0x80190193 | HTTP 403：禁止访问此资源。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP_E_STATUS_NOT_FOUND | 0x80190194 | HTTP 404：未找到所请求的资源。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP_E_STATUS_BAD_METHOD | 0x80190195 | HTTP 方法对此终结点无效。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP_E_STATUS_NONE_ACCEPTABLE | 0x80190196 | HTTP 406：没有可接受的表示形式可用。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP_E_STATUS_PROXY_AUTH_REQ | 0x80190197 | HTTP 407：需要代理身份验证。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP_E_STATUS_REQUEST_TIMEOUT | 0x80190198 | HTTP 408：服务器等待请求时超时。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP_E_STATUS_CONFLICT | 0x80190199 | HTTP 409：请求与当前服务器状态冲突。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP_E_STATUS_GONE | 0x8019019A | HTTP 410：所请求的资源不再可用。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP_E_STATUS_LENGTH_REQUIRED | 0x8019019B | HTTP 411：需要提供 Content-Length。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP_E_STATUS_PRECOND_FAILED | 0x8019019C | HTTP 412：请求先决条件失败。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP_E_STATUS_REQUEST_TOO_LARGE | 0x8019019D | HTTP 413：请求负载过大。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP_E_STATUS_URI_TOO_LONG | 0x8019019E | HTTP 414：请求 URI 过长。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP_E_STATUS_UNSUPPORTED_MEDIA | 0x8019019F | HTTP 415：不支持该媒体类型。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP_E_STATUS_RANGE_NOT_SATISFIABLE | 0x801901A0 | HTTP 416：无法满足请求的范围。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP_E_STATUS_EXPECTATION_FAILED | 0x801901A1 | HTTP 417：服务器无法满足请求期望。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| FGRL (Rate Limit) Exceeded | 0x801901AD | 因超出速率限制，请求被限流。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 降低请求速率，并在冷却后使用指数退避策略重试。 |
| HTTP_E_STATUS_SERVER_ERROR | 0x801901F4 | HTTP 500：服务器遇到内部错误。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP_E_STATUS_NOT_SUPPORTED | 0x801901F5 | 请求的 HTTP 功能不受支持。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP_E_STATUS_BAD_GATEWAY | 0x801901F6 | HTTP 502：从上游服务器收到无效响应。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP_E_STATUS_SERVICE_UNAVAIL | 0x801901F7 | HTTP 503：服务暂时不可用。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP_E_STATUS_GATEWAY_TIMEOUT | 0x801901F8 | HTTP 504：上游服务器超时。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP_E_STATUS_VERSION_NOT_SUP | 0x801901F9 | 服务器不支持该 HTTP 版本。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| ONL_E_ACTION_REQUIRED | 0x8086000C | 操作继续之前需要用户或标题采取行动。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 完成服务指示的必要用户/标题操作，然后重试。 |
| WEB_E_UNEXPECTED_CONTENT | 0x83750005 | 响应内容与预期格式不匹配。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 验证响应格式/内容类型和服务协定，然后重试。 |
| WEB_E_INVALID_JSON_STRING | 0x83750007 | JSON 负载无效或格式错误。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 在发送或解析之前验证 JSON 负载的架构/编码。 |
| E_HC_NOT_INITIALISED | 0x89235001 | HTTP 客户端运行时未初始化。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 在发出请求之前初始化 HTTP 客户端运行时。 |
| E_HC_PERFORM_ALREADY_CALLED | 0x89235003 | 此 HTTP 操作已执行过。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 为另一次 perform 调用创建新的请求对象。 |
| E_HC_ALREADY_INITIALISED | 0x89235004 | HTTP 客户端运行时已初始化。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 避免重复初始化；在每个进程生命周期中仅初始化一次。 |
| E_HC_CONNECT_ALREADY_CALLED | 0x89235005 | 此 WebSocket/会话上已调用过 Connect。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 复用活动连接/会话或新建一个，而不是重新连接。 |
| E_HC_NO_NETWORK | 0x89235006 | 当前没有可用的网络连接。 | XBOX Live HRESULT 错误代码 (HTTP Client) | 恢复网络连接后重试。 |
身份验证管理器 (AM)
| 代码 | 值 | 说明 | 来源 | 故障排除 |
|---|---|---|---|---|
| AM_E_XSTS_UNEXPECTED | 0x87DD0006 | 已配置 NSAL 目标，但依赖方证书尚未被 XBOX 服务信任。 | XUserGetTokenAndSignatureResult | 验证沙盒、NSAL 目标、TitleId/SCID 配置，并重新获取令牌。 |
| AM_E_NOT_AUTHORIZED | 0x87DD0009 | 用户无权在当前 TitleId 和 SandboxId 配置下请求 XSTS 令牌。 | 沙盒设置故障排除 | 验证沙盒、NSAL 目标、TitleId/SCID 配置，并重新获取令牌。 |
| AM_E_UNKNOWN_TARGET | 0x87DD000B | 在标题的 NSAL 配置中未找到请求的令牌目标。 | XUserGetTokenAndSignatureResult | 验证沙盒、NSAL 目标、TitleId/SCID 配置，并重新获取令牌。 |
| AM_E_TITLE_NOT_AUTHENTICATED | 0x87DD000D | 标题未针对当前服务配置进行身份验证（例如 TitleId、SCID 或沙盒设置问题）。 | 沙盒设置故障排除 | 验证沙盒、NSAL 目标、TitleId/SCID 配置，并重新获取令牌。 |
| AM_E_USER_NOT_FOUND | 0x87DD0013 | 用户对象已注销或未知。 | XUserGetTokenAndSignatureResult | 验证沙盒、NSAL 目标、TitleId/SCID 配置，并重新获取令牌。 |
| AM_E_XSTS_TIMEOUT | 0x87DD0019 | 尝试检索 X-token 时达到超时限制。 | XUserGetTokenAndSignatureResult | 验证沙盒、NSAL 目标、TitleId/SCID 配置，并重新获取令牌。 |
| AM_E_NO_TOKEN_REQUIRED | 0x87DD0021 | 请求的终结点不需要令牌，因为它未在 NSAL 中配置为令牌目标。 | XUserGetTokenAndSignatureResult | 验证沙盒、NSAL 目标、TitleId/SCID 配置，并重新获取令牌。 |
| AM_E_XTITLE_TIMEOUT | 0x87DD0022 | 尝试检索标题令牌时达到超时限制。 | XUserGetTokenAndSignatureResult | 验证沙盒、NSAL 目标、TitleId/SCID 配置，并重新获取令牌。 |
| AM_E_XSTS_SERVICE_UNAVAILABLE | 0x87DD0033 | X token 服务不可用。 | XUserGetTokenAndSignatureResult | 验证沙盒、NSAL 目标、TitleId/SCID 配置，并重新获取令牌。 |
XUser 令牌与签名
| 代码 | 值 | 说明 | 来源 | 故障排除 |
|---|---|---|---|---|
| WININET_E_NAME_NOT_RESOLVED | 0x80072EE7 | 无法解析服务器名称或地址。 | XUserGetTokenAndSignatureResult | 检查网络/DNS/代理连接，然后重试获取令牌。 |
| WININET_E_CANNOT_CONNECT | 0x80072EFD | 无法与服务器建立连接。 | XUserGetTokenAndSignatureResult | 检查网络/DNS/代理连接，然后重试获取令牌。 |
| WININET_E_CONNECTION_ABORTED | 0x80072EFE | 与服务器的连接异常终止。 | XUserGetTokenAndSignatureResult | 检查网络/DNS/代理连接，然后重试获取令牌。 |
| WININET_E_DECODING_FAILED | 0x80072F8F | 内容解码失败。 | XUserGetTokenAndSignatureResult | 检查网络/DNS/代理连接，然后重试获取令牌。 |
| XO_E_GAME_USAGE_BY_USER_EXCEEDED | 0x8015DBFF | 用户已超出允许玩此游戏的时间配额（家长控制）。 | XUserGetTokenAndSignatureResult | 解决账户/系统策略限制后重试获取令牌。 |
| XO_E_SYSTEM_UPDATE_REQUIRED | 0x8015DC01 | 必须先更新系统，才能授予 X-token。 | XUserGetTokenAndSignatureResult | 解决账户/系统策略限制后重试获取令牌。 |
| XO_E_ACCOUNT_COUNTRY_NOT_AUTHORIZED | 0x8015DC0B | 试图在未获授权的国家/地区使用该标题。 | XUserGetTokenAndSignatureResult | 解决账户/系统策略限制后重试获取令牌。 |
| XO_E_DEVICE_COUNT_FOR_TITLE_EXCEEDED | 0x8015DC1E | 你已在另一台设备上运行此游戏。请关闭该游戏才能在此处运行。单一存在点 (SPoP / XR-115) 强制执行。 | XUserGetTokenAndSignatureResult | 解决账户/系统策略限制后重试获取令牌。 |
| ONL_E_FORCESIGNIN | 0x80860006 | 为帮助保护账户，用户必须再次登录。 | XUserGetTokenAndSignatureResult | 提示用户再次登录后重试请求。 |
XAL
| 代码 | 值 | 说明 | 来源 | 故障排除 |
|---|---|---|---|---|
| E_XAL_NOTINITIALIZED | 0x89235001 | XAL 未初始化。 | XBOX Live HRESULT 错误代码 (XAL) | 在使用依赖 XAL 的 API 之前先初始化 XAL。 |
| E_XAL_ALREADYINITIALIZED | 0x89235101 | XAL 已被初始化。 | XBOX Live HRESULT 错误代码 (XAL) | 避免在同一生命周期内重复初始化 XAL。 |
| E_XAL_USERSETNOTEMPTY | 0x89235102 | 目标用户集非空。 | XBOX Live HRESULT 错误代码 (XAL) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E_XAL_USERSETFULL | 0x89235103 | 用户集已达到其最大容量。 | XBOX Live HRESULT 错误代码 (XAL) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E_XAL_USERSIGNEDOUT | 0x89235104 | 目标用户已注销。 | XBOX Live HRESULT 错误代码 (XAL) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E_XAL_DUPLICATEDUSER | 0x89235105 | 用户已存在于用户集中。 | XBOX Live HRESULT 错误代码 (XAL) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E_XAL_NETWORK | 0x89235106 | 处理请求时发生网络错误。 | XBOX Live HRESULT 错误代码 (XAL) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E_XAL_CLIENTERROR | 0x89235107 | XAL 中发生客户端错误。 | XBOX Live HRESULT 错误代码 (XAL) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E_XAL_UIREQUIRED | 0x89235108 | 需要用户交互才能完成操作。 | XBOX Live HRESULT 错误代码 (XAL) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E_XAL_HANDLERALREADYREGISTERED | 0x89235109 | 所需的处理程序已被注册。 | XBOX Live HRESULT 错误代码 (XAL) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E_XAL_UNEXPECTEDUSERSIGNEDIN | 0x8923510A | 操作过程中登录了不同或意外的用户。 | XBOX Live HRESULT 错误代码 (XAL) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E_XAL_NOTATTACHEDTOJVM | 0x8923510B | 需要时 XAL 未附加到 Java VM。 | XBOX Live HRESULT 错误代码 (XAL) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E_XAL_DEVICEUSER | 0x8923510C | 当前设备用户上下文中不允许该操作。 | XBOX Live HRESULT 错误代码 (XAL) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E_XAL_DEFERRALNOTAVAILABLE | 0x8923510D | 此时无法请求延迟。 | XBOX Live HRESULT 错误代码 (XAL) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E_XAL_MISSINGPLATFORMEVENTHANDLER | 0x8923510E | 缺少所需的平台事件处理程序。 | XBOX Live HRESULT 错误代码 (XAL) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E_XAL_USERNOTFOUND | 0x8923510F | 找不到指定的用户。 | XBOX Live HRESULT 错误代码 (XAL) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E_XAL_NOTOKENREQUIRED | 0x89235110 | 此请求不需要令牌。 | XBOX Live HRESULT 错误代码 (XAL) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E_XAL_NODEFAULTUSER | 0x89235111 | 当前没有可用的默认用户。 | XBOX Live HRESULT 错误代码 (XAL) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E_XAL_FAILEDTORESOLVE | 0x89235112 | XAL 无法解析请求的特权或身份状态。 | XBOX Live HRESULT 错误代码 (XAL) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
XSAPI
| 代码 | 值 | 说明 | 来源 | 故障排除 |
|---|---|---|---|---|
| E_XBL_RUNTIME_ERROR | 0x89235200 | 发生了通用的 XBOX Live 运行时错误。 | XBOX Live HRESULT 错误代码 (XSAPI) | 验证 XSAPI 初始化、身份验证令牌可用性以及服务状态后重试。 |
| E_XBL_RTA_GENERIC_ERROR | 0x89235201 | 发生了通用实时活动 (RTA) 错误。 | XBOX Live HRESULT 错误代码 (XSAPI) | 验证 XSAPI 初始化、身份验证令牌可用性以及服务状态后重试。 |
| E_XBL_RTA_SUBSCRIPTION_LIMIT_REACHED | 0x89235202 | 已达到 RTA 订阅上限。 | XBOX Live HRESULT 错误代码 (XSAPI) | 验证 XSAPI 初始化、身份验证令牌可用性以及服务状态后重试。 |
| E_XBL_RTA_ACCESS_DENIED | 0x89235203 | 拒绝访问 RTA 功能。 | XBOX Live HRESULT 错误代码 (XSAPI) | 验证 XSAPI 初始化、身份验证令牌可用性以及服务状态后重试。 |
| E_XBL_AUTH_UNKNOWN_ERROR | 0x89235204 | 发生了未知的身份验证错误。 | XBOX Live HRESULT 错误代码 (XSAPI) | 验证 XSAPI 初始化、身份验证令牌可用性以及服务状态后重试。 |
| E_XBL_AUTH_RUNTIME_ERROR | 0x89235205 | 由于运行时错误，身份验证失败。 | XBOX Live HRESULT 错误代码 (XSAPI) | 验证 XSAPI 初始化、身份验证令牌可用性以及服务状态后重试。 |
| E_XBL_AUTH_NO_TOKEN | 0x89235206 | 没有可用的身份验证令牌。 | XBOX Live HRESULT 错误代码 (XSAPI) | 验证 XSAPI 初始化、身份验证令牌可用性以及服务状态后重试。 |
| E_XBL_ALREADY_INITIALIZED | 0x89235207 | XBOX Live 服务已初始化。 | XBOX Live HRESULT 错误代码 (XSAPI) | 避免重复调用 XBOX 服务的初始化。 |
| E_XBL_NOT_INITIALIZED | 0x89235208 | XBOX Live 服务未初始化。 | XBOX Live HRESULT 错误代码 (XSAPI) | 在调用 XBOX 服务 API 之前先调用 XblInitialize。 |
| E_XBL_RTA_NOT_ACTIVATED | 0x89235209 | 实时活动服务未激活。请调用 XblRealTimeActivityActivate 以激活实时活动服务。 | 错误查找 (xberror.exe) | 实时活动服务未激活。请调用 XblRealTimeActivityActivate 以激活实时活动服务。(0x89235209) |
主机工具与传输
| 代码 | 值 | 说明 | 来源 | 故障排除 |
|---|---|---|---|---|
| E_APP_USER_TERMINATE_REQUEST | 0x87E1001D | 用户明确请求终止应用。 | 错误查找 (xberror.exe) | 用户明确请求终止应用。(0x87E1001D) |
| E_DSTORAGE_XVD_DEVICE_NOT_SUPPORTED | 0x89240004 | 指定的 XVD 不在受支持的 NVMe 设备上。 | 错误查找 (xberror.exe) | 指定的 XVD 不在受支持的 NVMe 设备上。 |
| E_COULD_NOT_CONNECT | 0x8C110303 | 无法连接到指定的开发工具包。 | XTF 传输错误 | 无法与目标主机建立连接。请验证指定的 HostName 或 IP 地址。检查防火墙、网络设置以及能否 ping 通该主机。 |
| E_XTFAPP_APPLICATION_EXITED_BEFORE_ACTIVATION_COMPLETE | 0x8D160122 | 应用在完成激活之前退出或崩溃。 | XTF 传输错误 | 无。 |
| E_XTFAPP_DIRECTORY_NOT_FOUND | 0x8D16018D | 未找到提供的目录。 | XTF 传输错误 | 请确保该目录存在。 |
XBOX PC 远程迭代
| 代码 | 值 | 说明 | 来源 | 故障排除 |
|---|---|---|---|---|
| E_PROCESSNOTFOUND | 0x8C114002 | 找不到进程。请验证进程 ID 与活动的目标进程匹配。 | XBOX PC 远程迭代 API 错误代码 | 通过检查正在运行的进程列表来验证目标进程的进程 ID；提供活动进程的有效进程 ID |
| E_INVALIDPROCESSID | 0x8C114003 | 进程 ID 无效。请提供数字形式的进程 ID。 | XBOX PC 远程迭代 API 错误代码 | 提供仅包含数字的有效进程 ID |
| E_INVALIDPIN | 0x8C114004 | PIN 的格式不符合预期。请输入有效的 6 位 PIN。 | XBOX PC 远程迭代 API 错误代码 | 在客户端设备上输入正确的 PIN |
| E_INVALIDSSHKEY | 0x8C114005 | SSH 密钥格式不符合预期。请使用有效的公钥并重新执行配对。 | XBOX PC 远程迭代 API 错误代码 | 生成有效的 SSH 公钥；再次执行配对，并提供有效密钥的路径 |
| E_PAIRINGTIMEOUT | 0x8C114006 | 配对模式超过了最长时间。请重新启动配对并在 2 分钟内输入 PIN。 | XBOX PC 远程迭代 API 错误代码 | 重新启动 PIN 配对过程；在超时（2 分钟）之前在客户端设备上输入 PIN |
| E_TOOMANYFAILURES | 0x8C114007 | PIN 尝试失败次数过多。请重新启动配对并输入正确的 PIN。 | XBOX PC 远程迭代 API 错误代码 | 重新启动 PIN 配对过程；在客户端设备上输入正确的 PIN |
| E_CLIENTNOTAUTHORIZED | 0x8C114008 | 设备拒绝了客户端。请成功完成配对，然后重试连接。 | XBOX PC 远程迭代 API 错误代码 | 成功完成 PIN 配对过程；再次执行连接请求 |
| E_SERVERNOTAUTHORIZED | 0x8C114009 | 客户端拒绝了设备。请成功完成配对，然后重试连接。 | XBOX PC 远程迭代 API 错误代码 | 成功完成 PIN 配对过程；再次执行连接请求 |
| E_SSHKEYTOOLARGE | 0x8C11400A | SSH 密钥过大。请生成受支持类型/大小的密钥并使用该密钥重试。 | XBOX PC 远程迭代 API 错误代码 | 使用受支持的算法和大小生成新的 SSH 密钥（例如 ED25519 或 RSA-2048）；确保为 RIT 连接指定了正确的密钥 |
| E_GAMENOTSUSPENDED | 0x8C11400B | 无法恢复指定的进程。请在调用 resume 之前验证该进程处于挂起状态。 | XBOX PC 远程迭代 API 错误代码 | 在恢复之前验证进程状态；确保没有其他工具已恢复或终止该进程 |
| E_GAMENOTRUNNING | 0x8C11400C | 没有正在运行的游戏进程。请在调用游戏进程操作之前启动游戏。 | XBOX PC 远程迭代 API 错误代码 | 验证当前正在运行的进程；在使用依赖游戏进程的 API 之前启动游戏。 |
| E_GAMEOVERSUSPENDED | 0x8C11400D | 线程挂起计数不为零。请反复恢复直到挂起计数降为零，或重新启动进程。 | XBOX PC 远程迭代 API 错误代码 | 反复恢复线程直到挂起计数降为零，或重新启动进程以重置线程状态；也可以重新启动进程以重置线程状态 |
| E_GAMESTILLRUNNING | 0x8C11400E | 一次只能运行一个游戏。请在启动新游戏之前停止当前正在运行的游戏。 | XBOX PC 远程迭代 API 错误代码 | 确保没有之前的游戏进程在运行；在启动新游戏之前终止当前正在运行的游戏（如有）；重试启动游戏进程 |
| E_GAMEEXITABANDONED | 0x8C11400F | 等待游戏退出的操作已放弃。请验证 PID/TID 并重试终止。 | XBOX PC 远程迭代 API 错误代码 | 检查游戏进程是否仍在运行；验证是否为终止提供了正确的进程 ID 和线程 ID；重试终止该进程 |
| E_GAMEFILEPATHNOTEXIST | 0x8C114010 | 游戏文件路径不存在。请验证远程路径并确认部署已成功。 | XBOX PC 远程迭代 API 错误代码 | 验证该路径在远程设备上存在；确认部署已成功 |
| E_SERVERTOOOLD | 0x8C114011 | 服务器版本对此客户端过旧。请在远程计算机上更新 wdEndpoint。 | XBOX PC 远程迭代 API 错误代码 | 将远程计算机上的 wdEndpoint 更新到最新版本 |
| E_NAMERESOLUTIONFAILED | 0x8C114012 | 无法解析远程计算机名。请验证主机名和 DNS，或使用 IP 地址进行测试。 | XBOX PC 远程迭代 API 错误代码 | 验证主机名拼写、DNS 配置和网络连接；使用 IP 地址隔离名称解析问题。 |
| E_INVALIDADDRESS | 0x8C114013 | 地址无效。请更正地址格式并使用有效的 IPv4 地址。 | XBOX PC 远程迭代 API 错误代码 | 确认正确的 IP 地址；更正地址格式并确保使用 IPv4 协议 |
| E_CONNECTIONERROR | 0x8C114014 | 连接失败。请检查网络/防火墙/服务可用性，然后重试。 | XBOX PC 远程迭代 API 错误代码 | 检查网络连接、防火墙规则、远程计算机上的服务可用性；检查设备之间的可见性，两台设备应能互相 ping 通；在启用日志记录的情况下重试连接。 |
| E_LISTENERALREADYRUNNING | 0x8C114015 | 另一个侦听器处于活动状态。请停止现有的终结点实例或复用它。 | XBOX PC 远程迭代 API 错误代码 | - 在启动新实例之前停止现有的终结点运行实例；或者，直接复用已在运行的终结点实例，而不是启动新实例 |
| E_ADMIN_REQUIRED | 0x8C114016 | 需要管理员权限。请以管理员身份运行终结点。 | XBOX PC 远程迭代 API 错误代码 | 以管理员身份重新运行终结点 |
| E_INVALIDTHREADID | 0x8C114017 | 线程 ID 无效。请提供数字形式的线程 ID。 | XBOX PC 远程迭代 API 错误代码 | 提供仅包含数字的有效线程 ID |
| E_INVALIDPIDTID_PAIR | 0x8C114018 | 进程 ID 与线程 ID 不关联。请对该进程重新查询线程并重试。 | XBOX PC 远程迭代 API 错误代码 | 重新从进程中查询线程列表；确保 ID 未被缓存或过时；验证线程 ID 来自正确的进程上下文。 |
| E_THREADNOTFOUND | 0x8C114019 | 找不到线程。请重新查询当前线程 ID，并使用非过时的 ID 重试。 | XBOX PC 远程迭代 API 错误代码 | 重新从进程中查询线程列表；确保 ID 未被缓存或过时；验证线程 ID 来自正确的进程上下文。 |
XAPU
| 代码 | 值 | 说明 | 来源 | 故障排除 |
|---|---|---|---|---|
| XAPU_E_QUEUE_FULL | 0x8AC81000 | XAPU 命令队列已满。 | XAPU 错误 | XAPU 命令队列已满。 |
| XAPU_E_PENDING_RESULTS | 0x8AC81001 | 当前没有可用的结果。 | XAPU 错误 | 当前没有可用的结果。 |
| XAPU_E_INVALID_COMMAND | 0x8AC81002 | 无效的 XAPU 命令值。 | XAPU 错误 | 无效的 XAPU 命令值。 |
| XAPU_E_INVALID_STREAM_INDEX | 0x8AC81003 | 提交的 XAPU 命令中流索引无效。 | XAPU 错误 | 提交的 XAPU 命令中流索引无效。 |
| XAPU_E_NO_DEVICE_RESOURCES | 0x8AC81004 | 系统资源不足以支持所请求的流数量。 | XAPU 错误 | 系统资源不足以支持所请求的流数量。 |
| XAPU_E_ALREADY_ACTIVE | 0x8AC81005 | 流已处于活动状态。 | XAPU 错误 | 流已处于活动状态。 |
| XAPU_E_BUFFER_TOO_SMALL | 0x8AC81006 | 输出缓冲区太小，无法容纳数据。 | XAPU 错误 | 输出缓冲区太小，无法容纳数据。 |
| XAPU_E_PROCESSING_ERROR | 0x8AC81007 | 硬件未能处理该命令。 | XAPU 错误 | 硬件未能处理该命令。 |
| XAPU_E_BAD_OPUS_PACKET | 0x8AC81008 | 硬件在解码 Opus 数据包时遇到错误。请检查编码是否存在错误。 | XAPU 错误 | 硬件在解码 Opus 数据包时遇到错误。请检查编码是否存在错误。 |
| XAPU_E_DEVICE_FAULT | 0x8AC81050 | 发生了不可恢复的固件崩溃。 | XAPU 错误 | 发生了不可恢复的固件崩溃。 |
| XAPU_E_DEVICE_TIMEOUT | 0x8AC81051 | 硬件未及时响应。 | XAPU 错误 | 硬件未及时响应。 |
| XAPU_E_DEVICE_FATAL_ERROR | 0x8AC81052 | 硬件遇到错误，需要重新建立连接。 | XAPU 错误 | 硬件遇到错误，需要重新建立连接。 |
XDSP
| 代码 | 值 | 说明 | 来源 | 故障排除 |
|---|---|---|---|---|
| XDSP_E_QUEUE_FULL | 0x8AC810A0 | 命令队列已满。请等待足够的时间让硬件完成对已提交命令的处理，然后再提交更多命令。 | XDSP 错误 | 命令队列已满。请等待足够的时间让硬件完成对已提交命令的处理，然后再提交更多命令。 |
| XDSP_E_PENDING_RESULTS | 0x8AC810A1 | 在收到所有已提交命令的结果之前，XDspStream 就已停用。请等待足够的时间让硬件完成对流的已提交命令的处理，然后再停用该流。 | XDSP 错误 | 在收到所有已提交命令的结果之前，XDspStream 就已停用。请等待足够的时间让硬件完成对流的已提交命令的处理，然后再停用该流。 |
| XDSP_E_NO_DEVICE_RESOURCES | 0x8AC810A2 | 没有可用的 XDSP 设备资源来处理你的请求。 | XDSP 错误 | 没有可用的 XDSP 设备资源来处理你的请求。 |
| XDSP_E_DEVICE_FATAL_ERROR | 0x8AC810A3 | 当前处理的命令发生了致命错误（例如崩溃/挂起）。请查看 XDspStatus 结构以了解哪个命令序列失败。硬件具有自动恢复机制，允许后续命令继续得到处理。 | XDSP 错误 | 当前处理的命令发生了致命错误（例如崩溃/挂起）。请查看 XDspStatus 结构以了解哪个命令序列失败。硬件具有自动恢复机制，允许后续命令继续得到处理。 |
| XDSP_E_NOT_ALL_HANDLES_DEACTIVATED | 0x8AC810A4 | 在与客户端关联的所有 XDspStream 对象停用之前，就对 XDspClient 调用了 XDspDisconnect。 | XDSP 错误 | 在与客户端关联的所有 XDspStream 对象停用之前，就对 XDspClient 调用了 XDspDisconnect。 |
| XDSP_E_MAX_CLIENTS_EXCEEDED | 0x8AC810A5 | 已创建的 XDspClient 数量达到上限。 | XDSP 错误 | 已创建的 XDspClient 数量达到上限。 |
| XDSP_E_MAX_AGGREGATE_IMPULSE_RESPONSE_EXCEEDED | 0x8AC810A6 | 当前的 XDspConnect 调用会导致 XDSP 超出所支持的最大聚合脉冲响应长度，因此无效。 | XDSP 错误 | 当前的 XDspConnect 调用会导致 XDSP 超出所支持的最大聚合脉冲响应长度，因此无效。 |
| XDSP_E_INVALID_IMPULSE_RESPONSE_LENGTH | 0x8AC810A7 | 对 XDspActivate 的调用使用了过大或过小的脉冲响应长度。 | XDSP 错误 | 对 XDspActivate 的调用使用了过大或过小的脉冲响应长度。 |