> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 错误代码

> 在 XGameErr.h 中声明的 GDK 错误代码常量，按子系统组织，HRESULT 值按数值排序，方便 XBOX 与 PC 开发者查找。

Microsoft Game Development Kit (GDK) 错误代码值的常量定义，声明于 XGameErr.h 中。

本概述按子系统组织，每个表格按 `HRESULT` 值递增排序，方便按数值查找。

有关工具和平台 `HRESULT` 的全面覆盖信息（包括启动、部署和诊断工具场景），请参阅 [错误查找 (xberror.exe)](https://docs.xbox.com/zh-CN/tools/tools-console/commandlinetools/xberror.md)。

## 游戏运行时

| 代码 | 值 | 说明 | 来源 | 故障排除 |
| - | - | - | - | - |
| E\_GAME\_MISSING\_GAME\_CONFIG | 0x87E5001F | 此应用缺少必需的 MicrosoftGame.Config 文件。 | [MicrosoftGame.config 元素参考](https://docs.xbox.com/zh-CN/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc.md) | 向包中添加有效的 MicrosoftGame.config 文件，然后重新生成/重新部署。 |
| E\_GAMERUNTIME\_NOT\_INITIALIZED | 0x89240100 | 游戏运行时未初始化。 | [XGameRuntime](https://docs.xbox.com/zh-CN/reference/system/xgameruntimeinit/xgameruntimeinit_members.md) | 在重试之前，验证运行时的 init/uninit 顺序、包兼容性以及应用状态。 |
| E\_GAMERUNTIME\_DLL\_NOT\_FOUND | 0x89240101 | 未找到游戏运行时 DLL。 | [XGameRuntime](https://docs.xbox.com/zh-CN/reference/system/xgameruntimeinit/xgameruntimeinit_members.md) | 在重试之前，验证运行时的 init/uninit 顺序、包兼容性以及应用状态。 |
| E\_GAMERUNTIME\_VERSION\_MISMATCH | 0x89240102 | 游戏运行时 DLL 不支持此版本的 GDK。 | [XGameRuntime](https://docs.xbox.com/zh-CN/reference/system/xgameruntimeinit/xgameruntimeinit_members.md) | 在重试之前，验证运行时的 init/uninit 顺序、包兼容性以及应用状态。 |
| E\_GAMERUNTIME\_WINDOW\_NOT\_FOREGROUND | 0x89240103 | 此操作需要应用窗口位于前台。 | | 将应用窗口置于前台，然后重试该操作。 |
| E\_GAMERUNTIME\_SUSPENDED | 0x89240104 | 游戏运行时处于挂起状态。 | [XBOX 游戏生命周期](https://docs.xbox.com/zh-CN/build/console-features/console-workflows/xbox-game-life-cycle.md) | 在重试之前，验证运行时的 init/uninit 顺序、包兼容性以及应用状态。 |
| E\_GAMERUNTIME\_UNINITIALIZE\_ACTIVEOBJECTS | 0x89240105 | 在 XGameRuntimeUninitialize 时游戏运行时存在活动对象。 | [XGameRuntimeUninitialize](https://docs.xbox.com/zh-CN/reference/system/xgameruntimeinit/functions/xgameruntimeuninitialize.md) | 在重试之前，验证运行时的 init/uninit 顺序、包兼容性以及应用状态。 |
| E\_GAMERUNTIME\_MULTIPLAYER\_NOT\_CONFIGURED | 0x89240106 | 服务上未为此用户在此标题设置多人游戏活动。 | [XBOX 服务多人游戏](https://docs.xbox.com/zh-CN/services/xbox-services/multiplayer/overviews/live-multiplayer-intro.md) | 在重试之前，验证运行时的 init/uninit 顺序、包兼容性以及应用状态。 |
| E\_GAMERUNTIME\_OPTIONS\_MISMATCH | 0x89240109 | 运行时已使用一组不同的选项进行初始化。请先执行 Uninitialize，然后再使用新选项重新初始化。 | [XGameRuntimeUninitialize](https://docs.xbox.com/zh-CN/reference/system/xgameruntimeinit/functions/xgameruntimeuninitialize.md) | 在重试之前，验证运行时的 init/uninit 顺序、包兼容性以及应用状态。 |
| E\_GAMERUNTIME\_OPTIONS\_NOT\_SUPPORTED | 0x8924010A | 传入的选项与游戏包不兼容。游戏配置信息必须与包相匹配。 | [MicrosoftGame.config 元素参考](https://docs.xbox.com/zh-CN/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc.md) | 在重试之前，验证运行时的 init/uninit 顺序、包兼容性以及应用状态。 |
| E\_GAMERUNTIME\_GAMECONFIG\_BAD\_FORMAT | 0x8924010B | 传递给 Initialize 的游戏配置无法解析。 | [MicrosoftGame.config 元素参考](https://docs.xbox.com/zh-CN/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc.md) | 在重试之前，验证运行时的 init/uninit 顺序、包兼容性以及应用状态。 |
| E\_GAMERUNTIME\_INVALID\_HANDLE | 0x8924010C | 句柄在跨运行时初始化时无法使用。 | | 在重试之前，验证运行时的 init/uninit 顺序、包兼容性以及应用状态。 |

## 游戏用户

| 代码 | 值 | 说明 | 来源 | 故障排除 |
| - | - | - | - | - |
| E\_GAMEUSER\_MAX\_USERS\_ADDED | 0x89245100 | 无法添加此用户，因为已达到最大用户数量。 | [XUserAddAsync](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xuseraddasync.md) | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E\_GAMEUSER\_SIGNED\_OUT | 0x89245101 | 无法执行操作，因为该用户已注销。 | [XUserAddAsync](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xuseraddasync.md) | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E\_GAMEUSER\_RESOLVE\_USER\_ISSUE\_REQUIRED | 0x89245102 | 需要 UI 来解决此用户的问题。 | [XUserResolveIssueWithUiAsync](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xuserresolveissuewithuiasync.md) | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E\_GAMEUSER\_DEFERRAL\_NOT\_AVAILABLE | 0x89245103 | 此时不宜请求延迟。 | [XUserGetTokenAndSignatureAsync](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xusergettokenandsignatureasync.md) | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E\_GAMEUSER\_USER\_NOT\_FOUND | 0x89245104 | 找不到与该 ID 匹配的用户。 | | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E\_GAMEUSER\_NO\_TOKEN\_REQUIRED | 0x89245105 | 此调用不需要令牌。 | | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E\_GAMEUSER\_NO\_DEFAULT\_USER | 0x89245106 | 当前没有默认用户。如果收到此错误，请在不使用 AddDefaultUserSilently 的情况下再次调用 XUserAddAsync。 | [XUserAddAsync](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xuseraddasync.md) | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E\_GAMEUSER\_FAILED\_TO\_RESOLVE | 0x89245107 | 无法解析给定的特权。 | | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E\_GAMEUSER\_NO\_TITLE\_ID | 0x89245108 | 必须配置 XBOX Live TitleId。 | [MicrosoftGame.config 元素参考](https://docs.xbox.com/zh-CN/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc.md) | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E\_GAMEUSER\_UNKNOWN\_GAME\_IDENTITY | 0x89245109 | 游戏标识未被识别。MSAAppId 和 TitleId 与游戏关联的不匹配。 | [MicrosoftGame.config 元素参考](https://docs.xbox.com/zh-CN/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc.md) | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E\_GAMEUSER\_NO\_PACKAGE\_IDENTITY | 0x89245110 | 必须配置包标识。 | [Partner Center 初始配置](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-initial-configuration.md#1-reserving-a-name) | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E\_GAMEUSER\_FAILED\_TO\_GET\_TOKEN | 0x89245111 | 令牌请求失败。 | | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E\_GAMEUSER\_INVALID\_APP\_CONFIGURATION | 0x89245112 | 游戏配置中的 MSAAppId 无效或未针对身份验证堆栈进行配置。 | [MicrosoftGame.config 元素参考](https://docs.xbox.com/zh-CN/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc.md) | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E\_GAMEUSER\_MALFORMED\_MSAAPPID | 0x89245113 | 游戏配置中的 MSAAppId 与预期格式不匹配（16 字符字符串或 GUID）。 | | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E\_GAMEUSER\_INCONSISTENT\_MSAAPPID\_AND\_TITLEID | 0x89245114 | 游戏配置中的 MSAAppId 和 TitleId 与游戏关联的不匹配。 | [MicrosoftGame.config 元素参考](https://docs.xbox.com/zh-CN/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc.md) | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |

## 游戏包

| 代码 | 值 | 说明 | 来源 | 故障排除 |
| - | - | - | - | - |
| E\_GAMEPACKAGE\_APP\_NOT\_PACKAGED | 0x89245200 | 游戏未打包到容器中。 | | 验证包安装/内容状态，并在重新部署所需资源后重试。 |
| E\_GAMEPACKAGE\_NO\_INSTALLED\_LANGUAGES | 0x89245201 | 游戏使用智能分发有选择地安装语言，但未安装任何语言。 | [Intelligent Delivery 语言](https://docs.xbox.com/zh-CN/build/core-features/common/packaging/intelligentdelivery-language.md) | 验证包安装/内容状态，并在重新部署所需资源后重试。 |
| E\_GAMEPACKAGE\_NO\_STORE\_ID | 0x89245202 | 必须在应用的游戏配置中设置 StoreId 属性。 | [MicrosoftGame.config 元素参考](https://docs.xbox.com/zh-CN/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc.md) | 验证包安装/内容状态，并在重新部署所需资源后重试。 |
| E\_GAMEPACKAGE\_INVALID\_SELECTOR | 0x89245203 | 提供的区块选择器无法解析为包中的区块。 | [Chunk 元素参考](https://docs.xbox.com/zh-CN/build/core-features/common/packaging/deployment/deployment-element-chunk.md) | 验证包安装/内容状态，并在重新部署所需资源后重试。 |
| E\_GAMEPACKAGE\_DOWNLOAD\_REQUIRED | 0x89245204 | 必须下载一个或多个所需的区块，才能在此设备上装载该包。 | | 验证包安装/内容状态，并在重新部署所需资源后重试。 |
| E\_GAMEPACKAGE\_NO\_TAG\_CHANGE | 0x89245205 | 请使用 Features 而非 tags 更改此包中已安装的区块。 | [Intelligent Delivery recipes](https://docs.xbox.com/zh-CN/build/core-features/common/packaging/intelligentdelivery-features-recipes.md) | 验证包安装/内容状态，并在重新部署所需资源后重试。 |
| E\_GAMEPACKAGE\_DLC\_NOT\_SUPPORTED | 0x89245206 | 游戏不支持该 DLC 包。请确保游戏配置中的 DLC 兼容性正确。 | [MicrosoftGame.config 元素参考](https://docs.xbox.com/zh-CN/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc.md) | 验证包安装/内容状态，并在重新部署所需资源后重试。 |
| E\_GAMEPACKAGE\_DUPLICATE\_ID\_VALUES | 0x89245207 | 包中包含多个映射到相同 'ID' 属性的可执行文件。请检查 'Executable' 元素中是否存在重复的 'ID' 属性。 | [MicrosoftGame.config 元素参考](https://docs.xbox.com/zh-CN/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc.md) | 验证包安装/内容状态，并在重新部署所需资源后重试。 |
| E\_GAMEPACKAGE\_NO\_PACKAGE\_IDENTIFIER | 0x89245208 | 无法解析包的标识符。该包可能未安装。 | | 验证包安装/内容状态，并在重新部署所需资源后重试。 |
| E\_GAMEPACKAGE\_CONFIG\_NO\_ROOT\_NODE | 0x89245209 | 在 MicrosoftGame.config 文件中找不到根 `Game` 节点。请检查该文件格式是否正确。 | [MicrosoftGame.config 元素参考](https://docs.xbox.com/zh-CN/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc.md) | 更正 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 元素参考](https://docs.xbox.com/zh-CN/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc.md) | 更正 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 元素参考](https://docs.xbox.com/zh-CN/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc.md) | 更正 MicrosoftGame.config 架构/值，然后重新生成/重新部署包。 |
| E\_GAMEPACKAGE\_CONFIG\_NO\_CODE\_CLOUD\_SAVES\_REQUIRES\_MSAAPPID | 0x8924520E | 当使用无代码云保存（NoCodePCRoot 元素）且 configVersion >= 1 时，必须提供 'MSAAppId' 和 'TitleId' 元素。 | [MicrosoftGame.config 元素参考](https://docs.xbox.com/zh-CN/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc.md) | 更正 MicrosoftGame.config 架构/值，然后重新生成/重新部署包。 |
| E\_GAMEPACKAGE\_CONFIG\_MSAAPPID\_OR\_TITLEID\_IS\_DEFAULT | 0x8924520F | 'MSAAppId' 或 'TitleId' 元素为默认值。如果指定了 NoCodePCRoot 或 AdvancedUserModel，则在使用 configVersion >= 1 时，TitleId 和 MSAAppId 都必须是来自 Partner Center 的有效 ID。 | [MicrosoftGame.config 元素参考](https://docs.xbox.com/zh-CN/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc.md) | 更正 MicrosoftGame.config 架构/值，然后重新生成/重新部署包。 |

## 游戏商店

| 代码 | 值 | 说明 | 来源 | 故障排除 |
| - | - | - | - | - |
| E\_GAMESTORE\_LICENSE\_ACTION\_NOT\_APPLICABLE\_TO\_PRODUCT | 0x89245300 | 游戏为无法授权的产品请求了许可。 | [XStore 概述](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-overview.md) | 验证商店连接性、权益/许可证状态，然后重试请求。 |
| E\_GAMESTORE\_NETWORK\_ERROR | 0x89245301 | 游戏无法与商店网络通信。 | [XStore 概述](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-overview.md) | 验证商店连接性、权益/许可证状态，然后重试请求。 |
| E\_GAMESTORE\_SERVER\_ERROR | 0x89245302 | 游戏从商店服务器收到了错误的响应。 | [XStore 概述](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-overview.md) | 验证商店连接性、权益/许可证状态，然后重试请求。 |
| E\_GAMESTORE\_INSUFFICIENT\_QUANTITY | 0x89245303 | 用户所拥有的此消耗品数量不足以使用所请求的数量。 | [XStore 概述](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-overview.md) | 验证商店连接性、权益/许可证状态，然后重试请求。 |
| E\_GAMESTORE\_ALREADY\_PURCHASED | 0x89245304 | 用户已拥有此产品。 | [XStore 概述](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-overview.md) | 验证商店连接性、权益/许可证状态，然后重试请求。 |
| E\_GAMESTORE\_LICENSE\_ACTION\_THROTTLED | 0x89245305 | 游戏对该产品的许可查询过于频繁，现已被限流。同一产品在 10 分钟内的许可尝试次数上限为 30 次。 | [XStore 概述](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-overview.md) | 验证商店连接性、权益/许可证状态，然后重试请求。 |

## 游戏流式传输

| 代码 | 值 | 说明 | 来源 | 故障排除 |
| - | - | - | - | - |
| E\_GAMESTREAMING\_NOT\_INITIALIZED | 0x89245400 | XGameStreaming 运行时未初始化。请在调用其他 API 之前调用 XGameStreamingInitialize。 | [XGameStreamingInitialize](https://docs.xbox.com/zh-CN/reference/system/xgamestreaming/functions/xgamestreaminginitialize.md) | 确保流式传输已初始化且客户端/会话上下文有效，然后重试。 |
| 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](https://docs.xbox.com/zh-CN/reference/system/xgamesave/xgamesave_members.md) | 有关详细的故障排除指导，请参阅 [游戏保存调试](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/game-saves-debugging.md)。 |
| E\_GS\_NO\_ACCESS | 0x80830002 | 操作失败，因为标题无权访问容器存储空间。请检查 SCID 和 TitleId 是否配置正确。 | [XGameSave](https://docs.xbox.com/zh-CN/reference/system/xgamesave/xgamesave_members.md) | 有关详细的故障排除指导，请参阅 [游戏保存调试](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/game-saves-debugging.md)。 |
| E\_GS\_OUT\_OF\_LOCAL\_STORAGE | 0x80830003 | 设备没有足够的存储容量来保存游戏。 | [XGameSave](https://docs.xbox.com/zh-CN/reference/system/xgamesave/xgamesave_members.md) | 有关详细的故障排除指导，请参阅 [游戏保存调试](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/game-saves-debugging.md)。 |
| E\_GS\_USER\_CANCELED | 0x80830004 | 用户取消了游戏存档的下载。 | [XGameSave](https://docs.xbox.com/zh-CN/reference/system/xgamesave/xgamesave_members.md) | 有关详细的故障排除指导，请参阅 [游戏保存调试](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/game-saves-debugging.md)。 |
| E\_GS\_UPDATE\_TOO\_BIG | 0x80830005 | 存档更新的大小过大。XGameSave 更新的总大小必须小于 GS\_MAX\_BLOB\_SIZE（16 MB）。 | [XGameSave](https://docs.xbox.com/zh-CN/reference/system/xgamesave/xgamesave_members.md) | 有关详细的故障排除指导，请参阅 [游戏保存调试](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/game-saves-debugging.md)。 |
| E\_GS\_QUOTA\_EXCEEDED | 0x80830006 | 此用户在该标题的存储配额已超出。 | [XGameSave](https://docs.xbox.com/zh-CN/reference/system/xgamesave/xgamesave_members.md) | 有关详细的故障排除指导，请参阅 [游戏保存调试](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/game-saves-debugging.md)。 |
| E\_GS\_PROVIDED\_BUFFER\_TOO\_SMALL | 0x80830007 | 提供给 API 的缓冲区过小。 | [XGameSave](https://docs.xbox.com/zh-CN/reference/system/xgamesave/xgamesave_members.md) | 有关详细的故障排除指导，请参阅 [游戏保存调试](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/game-saves-debugging.md)。 |
| E\_GS\_BLOB\_NOT\_FOUND | 0x80830008 | 找不到指定的 blob。 | [XGameSave](https://docs.xbox.com/zh-CN/reference/system/xgamesave/xgamesave_members.md) | 有关详细的故障排除指导，请参阅 [游戏保存调试](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/game-saves-debugging.md)。 |
| E\_GS\_NO\_SERVICE\_CONFIGURATION | 0x80830009 | 标题未针对连接存储正确配置。请检查 SCID 是否正确，以及标题是否在 Partner Center 配置。 | [XGameSave](https://docs.xbox.com/zh-CN/reference/system/xgamesave/xgamesave_members.md) | 有关详细的故障排除指导，请参阅 [游戏保存调试](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/game-saves-debugging.md)。 |
| E\_GS\_CONTAINER\_NOT\_IN\_SYNC | 0x8083000A | 容器尚未同步。请确保 XGameSave 容器在提交更新之前已完成同步。 | [XGameSave](https://docs.xbox.com/zh-CN/reference/system/xgamesave/xgamesave_members.md) | 有关详细的故障排除指导，请参阅 [游戏保存调试](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/game-saves-debugging.md)。 |
| E\_GS\_CONTAINER\_SYNC\_FAILED | 0x8083000B | 容器同步失败。 | [XGameSave](https://docs.xbox.com/zh-CN/reference/system/xgamesave/xgamesave_members.md) | 有关详细的故障排除指导，请参阅 [游戏保存调试](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/game-saves-debugging.md)。 |
| E\_GS\_USER\_NOT\_REGISTERED\_IN\_SERVICE | 0x8083000C | 用户的 MSA 尚未成为 XBOX 服务账户。 | [XGameSave](https://docs.xbox.com/zh-CN/reference/system/xgamesave/xgamesave_members.md) | 有关详细的故障排除指导，请参阅 [游戏保存调试](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/game-saves-debugging.md)。 |
| E\_GS\_HANDLE\_EXPIRED | 0x8083000D | 函数使用的句柄已过期，必须重新获取。 | [XGameSave](https://docs.xbox.com/zh-CN/reference/system/xgamesave/xgamesave_members.md) | 有关详细的故障排除指导，请参阅 [游戏保存调试](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/game-saves-debugging.md)。 |
| E\_GS\_ASYNC\_FUNCTION\_REQUIRED | 0x8083000E | 此同步函数正在时间敏感线程上调用，可能导致死锁。请改用异步实现。 | [XGameSave](https://docs.xbox.com/zh-CN/reference/system/xgamesave/xgamesave_members.md) | 有关详细的故障排除指导，请参阅 [游戏保存调试](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/game-saves-debugging.md)。 |
| E\_GS\_PROVIDER\_MISMATCH | 0x8083000F | 游戏混合使用了 XGameSave 与 XGameSaveFiles 调用，这是不支持的。 | [XGameSave](https://docs.xbox.com/zh-CN/reference/system/xgamesave/xgamesave_members.md) | 有关详细的故障排除指导，请参阅 [游戏保存调试](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/game-saves-debugging.md)。 |

## 全局

| 代码 | 值 | 说明 | 来源 | 故障排除 |
| - | - | - | - | - |
| S\_OK | 0x00000000 | 操作成功完成。 | [XBOX Live HRESULT 错误代码（全局）](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#global) | 无需操作。 |
| E\_PENDING | 0x8000000A | 操作已启动但尚未完成。 | [XBOX Live HRESULT 错误代码（全局）](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#global) | 等待完成，然后再次查询异步结果。 |
| E\_BOUNDS | 0x8000000B | 提供的索引或范围超出有效边界。 | [XBOX Live HRESULT 错误代码（全局）](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#global) | 在重试之前验证索引和范围边界。 |
| E\_NOTIMPL | 0x80004001 | 未实现此功能。 | [XBOX Live HRESULT 错误代码（全局）](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#global) | 请为此平台和运行时使用受支持的 API 路径。 |
| E\_NOINTERFACE | 0x80004002 | 请求的接口在此对象上不可用。 | [XBOX Live HRESULT 错误代码（全局）](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#global) | 在查询此接口之前验证接口的可用性/版本。 |
| E\_POINTER | 0x80004003 | 必需的指针为空或无效。 | [XBOX Live HRESULT 错误代码（全局）](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#global) | 在调用之前验证所有指针/句柄和对象生存期。 |
| E\_ABORT | 0x80004004 | 操作在完成之前被中止。 | [XBOX Live HRESULT 错误代码（全局）](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#global) | 检查取消/关闭状态，稳定后重新运行。 |
| E\_FAIL | 0x80004005 | 操作失败，出现未指定的错误。 | [XBOX Live HRESULT 错误代码（全局）](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#global) | 查阅日志中先前的失败信息，并在更正输入/状态后重试。 |
| E\_UNEXPECTED | 0x8000FFFF | 发生了意外的内部错误。 | [XBOX Live HRESULT 错误代码（全局）](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#global) | 捕获诊断信息，重启该场景，如可重现则上报。 |
| E\_ACCESSDENIED | 0x80070005 | 拒绝访问所请求的资源或操作。 | [XBOX Live HRESULT 错误代码（全局）](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#global) | 验证权限、功能和用户/账户上下文，然后重试。 |
| E\_OUTOFMEMORY | 0x8007000E | 由于无法满足内存分配，操作失败。 | [XBOX Live HRESULT 错误代码（全局）](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#global) | 减小内存压力、释放分配后重试。 |
| E\_NOT\_SUPPORTED | 0x80070032 | 当前上下文不支持此操作。 | [XBOX Live HRESULT 错误代码（全局）](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#global) | 请在当前上下文中使用受支持的操作。 |
| E\_INVALIDARG | 0x80070057 | 一个或多个参数无效。 | [XBOX Live HRESULT 错误代码（全局）](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#global) | 在重试之前验证参数值以及必需的组合。 |
| E\_NOT\_SUFFICIENT\_BUFFER | 0x8007007A | 提供的缓冲区对请求的数据来说过小。 | [XBOX Live HRESULT 错误代码（全局）](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#global) | 查询所需大小、调整缓冲区大小后重试。 |
| E\_TIME\_CRITICAL\_THREAD | 0x800701A0 | 不允许在时间关键线程上调用。 | [XBOX Live HRESULT 错误代码（全局）](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#global) | 将此调用移出时间关键线程；可用时请使用异步模式。 |
| E\_NO\_TASK\_QUEUE | 0x800701AB | 未为该操作提供或没有可用的任务队列。 | [XBOX Live HRESULT 错误代码（全局）](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#global) | 在调用此操作之前提供有效的任务队列。 |

## HTTP 客户端

| 代码 | 值 | 说明 | 来源 | 故障排除 |
| - | - | - | - | - |
| HTTP\_E\_STATUS\_UNEXPECTED | 0x80190001 | HTTP 客户端遇到意外的协议/状态状况。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_UNEXPECTED\_SERVER\_ERROR | 0x80190005 | 服务器返回了意外的错误状况。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_AMBIGUOUS | 0x8019012C | HTTP 响应表示存在多个匹配资源。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_MOVED | 0x8019012D | HTTP 重定向指示资源已移动。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_REDIRECT | 0x8019012E | 收到 HTTP 重定向响应。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_REDIRECT\_METHOD | 0x8019012F | 需要更改方法的 HTTP 重定向。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_NOT\_MODIFIED | 0x80190130 | HTTP 304：自条件请求以来资源未发生变化。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_USE\_PROXY | 0x80190131 | HTTP 请求必须通过代理发送。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_REDIRECT\_KEEP\_VERB | 0x80190133 | 保留原始方法/动词的 HTTP 重定向。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_BAD\_REQUEST | 0x80190190 | HTTP 400：请求格式错误或无效。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_DENIED | 0x80190191 | HTTP 401：请求未经授权或被拒绝。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_PAYMENT\_REQ | 0x80190192 | HTTP 402：此请求需要付款。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_FORBIDDEN | 0x80190193 | HTTP 403：禁止访问此资源。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_NOT\_FOUND | 0x80190194 | HTTP 404：未找到所请求的资源。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_BAD\_METHOD | 0x80190195 | HTTP 方法对此终结点无效。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_NONE\_ACCEPTABLE | 0x80190196 | HTTP 406：没有可接受的表示形式可用。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_PROXY\_AUTH\_REQ | 0x80190197 | HTTP 407：需要代理身份验证。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_REQUEST\_TIMEOUT | 0x80190198 | HTTP 408：服务器等待请求时超时。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_CONFLICT | 0x80190199 | HTTP 409：请求与当前服务器状态冲突。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_GONE | 0x8019019A | HTTP 410：所请求的资源不再可用。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_LENGTH\_REQUIRED | 0x8019019B | HTTP 411：需要提供 Content-Length。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_PRECOND\_FAILED | 0x8019019C | HTTP 412：请求先决条件失败。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_REQUEST\_TOO\_LARGE | 0x8019019D | HTTP 413：请求负载过大。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_URI\_TOO\_LONG | 0x8019019E | HTTP 414：请求 URI 过长。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_UNSUPPORTED\_MEDIA | 0x8019019F | HTTP 415：不支持该媒体类型。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_RANGE\_NOT\_SATISFIABLE | 0x801901A0 | HTTP 416：无法满足请求的范围。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_EXPECTATION\_FAILED | 0x801901A1 | HTTP 417：服务器无法满足请求期望。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| FGRL (Rate Limit) Exceeded | 0x801901AD | 因超出速率限制，请求被限流。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 降低请求速率，并在冷却后使用指数退避策略重试。 |
| HTTP\_E\_STATUS\_SERVER\_ERROR | 0x801901F4 | HTTP 500：服务器遇到内部错误。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_NOT\_SUPPORTED | 0x801901F5 | 请求的 HTTP 功能不受支持。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_BAD\_GATEWAY | 0x801901F6 | HTTP 502：从上游服务器收到无效响应。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_SERVICE\_UNAVAIL | 0x801901F7 | HTTP 503：服务暂时不可用。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_GATEWAY\_TIMEOUT | 0x801901F8 | HTTP 504：上游服务器超时。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_VERSION\_NOT\_SUP | 0x801901F9 | 服务器不支持该 HTTP 版本。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| ONL\_E\_ACTION\_REQUIRED | 0x8086000C | 操作继续之前需要用户或标题采取行动。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 完成服务指示的必要用户/标题操作，然后重试。 |
| WEB\_E\_UNEXPECTED\_CONTENT | 0x83750005 | 响应内容与预期格式不匹配。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 验证响应格式/内容类型和服务协定，然后重试。 |
| WEB\_E\_INVALID\_JSON\_STRING | 0x83750007 | JSON 负载无效或格式错误。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 在发送或解析之前验证 JSON 负载的架构/编码。 |
| E\_HC\_NOT\_INITIALISED | 0x89235001 | HTTP 客户端运行时未初始化。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 在发出请求之前初始化 HTTP 客户端运行时。 |
| E\_HC\_PERFORM\_ALREADY\_CALLED | 0x89235003 | 此 HTTP 操作已执行过。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 为另一次 perform 调用创建新的请求对象。 |
| E\_HC\_ALREADY\_INITIALISED | 0x89235004 | HTTP 客户端运行时已初始化。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 避免重复初始化；在每个进程生命周期中仅初始化一次。 |
| E\_HC\_CONNECT\_ALREADY\_CALLED | 0x89235005 | 此 WebSocket/会话上已调用过 Connect。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 复用活动连接/会话或新建一个，而不是重新连接。 |
| E\_HC\_NO\_NETWORK | 0x89235006 | 当前没有可用的网络连接。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#http-client) | 恢复网络连接后重试。 |

## 身份验证管理器 (AM)

| 代码 | 值 | 说明 | 来源 | 故障排除 |
| - | - | - | - | - |
| AM\_E\_XSTS\_UNEXPECTED | 0x87DD0006 | 已配置 NSAL 目标，但依赖方证书尚未被 XBOX 服务信任。 | [XUserGetTokenAndSignatureResult](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xusergettokenandsignatureresult.md) | 验证沙盒、NSAL 目标、TitleId/SCID 配置，并重新获取令牌。 |
| AM\_E\_NOT\_AUTHORIZED | 0x87DD0009 | 用户无权在当前 TitleId 和 SandboxId 配置下请求 XSTS 令牌。 | [沙盒设置故障排除](https://docs.xbox.com/zh-CN/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes.md) | 验证沙盒、NSAL 目标、TitleId/SCID 配置，并重新获取令牌。 |
| AM\_E\_UNKNOWN\_TARGET | 0x87DD000B | 在标题的 NSAL 配置中未找到请求的令牌目标。 | [XUserGetTokenAndSignatureResult](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xusergettokenandsignatureresult.md) | 验证沙盒、NSAL 目标、TitleId/SCID 配置，并重新获取令牌。 |
| AM\_E\_TITLE\_NOT\_AUTHENTICATED | 0x87DD000D | 标题未针对当前服务配置进行身份验证（例如 TitleId、SCID 或沙盒设置问题）。 | [沙盒设置故障排除](https://docs.xbox.com/zh-CN/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes.md) | 验证沙盒、NSAL 目标、TitleId/SCID 配置，并重新获取令牌。 |
| AM\_E\_USER\_NOT\_FOUND | 0x87DD0013 | 用户对象已注销或未知。 | [XUserGetTokenAndSignatureResult](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xusergettokenandsignatureresult.md) | 验证沙盒、NSAL 目标、TitleId/SCID 配置，并重新获取令牌。 |
| AM\_E\_XSTS\_TIMEOUT | 0x87DD0019 | 尝试检索 X-token 时达到超时限制。 | [XUserGetTokenAndSignatureResult](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xusergettokenandsignatureresult.md) | 验证沙盒、NSAL 目标、TitleId/SCID 配置，并重新获取令牌。 |
| AM\_E\_NO\_TOKEN\_REQUIRED | 0x87DD0021 | 请求的终结点不需要令牌，因为它未在 NSAL 中配置为令牌目标。 | [XUserGetTokenAndSignatureResult](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xusergettokenandsignatureresult.md) | 验证沙盒、NSAL 目标、TitleId/SCID 配置，并重新获取令牌。 |
| AM\_E\_XTITLE\_TIMEOUT | 0x87DD0022 | 尝试检索标题令牌时达到超时限制。 | [XUserGetTokenAndSignatureResult](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xusergettokenandsignatureresult.md) | 验证沙盒、NSAL 目标、TitleId/SCID 配置，并重新获取令牌。 |
| AM\_E\_XSTS\_SERVICE\_UNAVAILABLE | 0x87DD0033 | X token 服务不可用。 | [XUserGetTokenAndSignatureResult](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xusergettokenandsignatureresult.md) | 验证沙盒、NSAL 目标、TitleId/SCID 配置，并重新获取令牌。 |

## XUser 令牌与签名

| 代码 | 值 | 说明 | 来源 | 故障排除 |
| - | - | - | - | - |
| WININET\_E\_NAME\_NOT\_RESOLVED | 0x80072EE7 | 无法解析服务器名称或地址。 | [XUserGetTokenAndSignatureResult](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xusergettokenandsignatureresult.md) | 检查网络/DNS/代理连接，然后重试获取令牌。 |
| WININET\_E\_CANNOT\_CONNECT | 0x80072EFD | 无法与服务器建立连接。 | [XUserGetTokenAndSignatureResult](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xusergettokenandsignatureresult.md) | 检查网络/DNS/代理连接，然后重试获取令牌。 |
| WININET\_E\_CONNECTION\_ABORTED | 0x80072EFE | 与服务器的连接异常终止。 | [XUserGetTokenAndSignatureResult](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xusergettokenandsignatureresult.md) | 检查网络/DNS/代理连接，然后重试获取令牌。 |
| WININET\_E\_DECODING\_FAILED | 0x80072F8F | 内容解码失败。 | [XUserGetTokenAndSignatureResult](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xusergettokenandsignatureresult.md) | 检查网络/DNS/代理连接，然后重试获取令牌。 |
| XO\_E\_GAME\_USAGE\_BY\_USER\_EXCEEDED | 0x8015DBFF | 用户已超出允许玩此游戏的时间配额（家长控制）。 | [XUserGetTokenAndSignatureResult](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xusergettokenandsignatureresult.md) | 解决账户/系统策略限制后重试获取令牌。 |
| XO\_E\_SYSTEM\_UPDATE\_REQUIRED | 0x8015DC01 | 必须先更新系统，才能授予 X-token。 | [XUserGetTokenAndSignatureResult](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xusergettokenandsignatureresult.md) | 解决账户/系统策略限制后重试获取令牌。 |
| XO\_E\_ACCOUNT\_COUNTRY\_NOT\_AUTHORIZED | 0x8015DC0B | 试图在未获授权的国家/地区使用该标题。 | [XUserGetTokenAndSignatureResult](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xusergettokenandsignatureresult.md) | 解决账户/系统策略限制后重试获取令牌。 |
| XO\_E\_DEVICE\_COUNT\_FOR\_TITLE\_EXCEEDED | 0x8015DC1E | 你已在另一台设备上运行此游戏。请关闭该游戏才能在此处运行。单一存在点 (SPoP / XR-115) 强制执行。 | [XUserGetTokenAndSignatureResult](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xusergettokenandsignatureresult.md) | 解决账户/系统策略限制后重试获取令牌。 |
| ONL\_E\_FORCESIGNIN | 0x80860006 | 为帮助保护账户，用户必须再次登录。 | [XUserGetTokenAndSignatureResult](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xusergettokenandsignatureresult.md) | 提示用户再次登录后重试请求。 |

## XAL

| 代码 | 值 | 说明 | 来源 | 故障排除 |
| - | - | - | - | - |
| E\_XAL\_NOTINITIALIZED | 0x89235001 | XAL 未初始化。 | [XBOX Live HRESULT 错误代码 (XAL)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#xal) | 在使用依赖 XAL 的 API 之前先初始化 XAL。 |
| E\_XAL\_ALREADYINITIALIZED | 0x89235101 | XAL 已被初始化。 | [XBOX Live HRESULT 错误代码 (XAL)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#xal) | 避免在同一生命周期内重复初始化 XAL。 |
| E\_XAL\_USERSETNOTEMPTY | 0x89235102 | 目标用户集非空。 | [XBOX Live HRESULT 错误代码 (XAL)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_USERSETFULL | 0x89235103 | 用户集已达到其最大容量。 | [XBOX Live HRESULT 错误代码 (XAL)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_USERSIGNEDOUT | 0x89235104 | 目标用户已注销。 | [XBOX Live HRESULT 错误代码 (XAL)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_DUPLICATEDUSER | 0x89235105 | 用户已存在于用户集中。 | [XBOX Live HRESULT 错误代码 (XAL)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_NETWORK | 0x89235106 | 处理请求时发生网络错误。 | [XBOX Live HRESULT 错误代码 (XAL)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_CLIENTERROR | 0x89235107 | XAL 中发生客户端错误。 | [XBOX Live HRESULT 错误代码 (XAL)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_UIREQUIRED | 0x89235108 | 需要用户交互才能完成操作。 | [XBOX Live HRESULT 错误代码 (XAL)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_HANDLERALREADYREGISTERED | 0x89235109 | 所需的处理程序已被注册。 | [XBOX Live HRESULT 错误代码 (XAL)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_UNEXPECTEDUSERSIGNEDIN | 0x8923510A | 操作过程中登录了不同或意外的用户。 | [XBOX Live HRESULT 错误代码 (XAL)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_NOTATTACHEDTOJVM | 0x8923510B | 需要时 XAL 未附加到 Java VM。 | [XBOX Live HRESULT 错误代码 (XAL)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_DEVICEUSER | 0x8923510C | 当前设备用户上下文中不允许该操作。 | [XBOX Live HRESULT 错误代码 (XAL)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_DEFERRALNOTAVAILABLE | 0x8923510D | 此时无法请求延迟。 | [XBOX Live HRESULT 错误代码 (XAL)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_MISSINGPLATFORMEVENTHANDLER | 0x8923510E | 缺少所需的平台事件处理程序。 | [XBOX Live HRESULT 错误代码 (XAL)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_USERNOTFOUND | 0x8923510F | 找不到指定的用户。 | [XBOX Live HRESULT 错误代码 (XAL)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_NOTOKENREQUIRED | 0x89235110 | 此请求不需要令牌。 | [XBOX Live HRESULT 错误代码 (XAL)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_NODEFAULTUSER | 0x89235111 | 当前没有可用的默认用户。 | [XBOX Live HRESULT 错误代码 (XAL)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_FAILEDTORESOLVE | 0x89235112 | XAL 无法解析请求的特权或身份状态。 | [XBOX Live HRESULT 错误代码 (XAL)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |

## XSAPI

| 代码 | 值 | 说明 | 来源 | 故障排除 |
| - | - | - | - | - |
| E\_XBL\_RUNTIME\_ERROR | 0x89235200 | 发生了通用的 XBOX Live 运行时错误。 | [XBOX Live HRESULT 错误代码 (XSAPI)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#xsapi) | 验证 XSAPI 初始化、身份验证令牌可用性以及服务状态后重试。 |
| E\_XBL\_RTA\_GENERIC\_ERROR | 0x89235201 | 发生了通用实时活动 (RTA) 错误。 | [XBOX Live HRESULT 错误代码 (XSAPI)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#xsapi) | 验证 XSAPI 初始化、身份验证令牌可用性以及服务状态后重试。 |
| E\_XBL\_RTA\_SUBSCRIPTION\_LIMIT\_REACHED | 0x89235202 | 已达到 RTA 订阅上限。 | [XBOX Live HRESULT 错误代码 (XSAPI)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#xsapi) | 验证 XSAPI 初始化、身份验证令牌可用性以及服务状态后重试。 |
| E\_XBL\_RTA\_ACCESS\_DENIED | 0x89235203 | 拒绝访问 RTA 功能。 | [XBOX Live HRESULT 错误代码 (XSAPI)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#xsapi) | 验证 XSAPI 初始化、身份验证令牌可用性以及服务状态后重试。 |
| E\_XBL\_AUTH\_UNKNOWN\_ERROR | 0x89235204 | 发生了未知的身份验证错误。 | [XBOX Live HRESULT 错误代码 (XSAPI)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#xsapi) | 验证 XSAPI 初始化、身份验证令牌可用性以及服务状态后重试。 |
| E\_XBL\_AUTH\_RUNTIME\_ERROR | 0x89235205 | 由于运行时错误，身份验证失败。 | [XBOX Live HRESULT 错误代码 (XSAPI)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#xsapi) | 验证 XSAPI 初始化、身份验证令牌可用性以及服务状态后重试。 |
| E\_XBL\_AUTH\_NO\_TOKEN | 0x89235206 | 没有可用的身份验证令牌。 | [XBOX Live HRESULT 错误代码 (XSAPI)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#xsapi) | 验证 XSAPI 初始化、身份验证令牌可用性以及服务状态后重试。 |
| E\_XBL\_ALREADY\_INITIALIZED | 0x89235207 | XBOX Live 服务已初始化。 | [XBOX Live HRESULT 错误代码 (XSAPI)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#xsapi) | 避免重复调用 XBOX 服务的初始化。 |
| E\_XBL\_NOT\_INITIALIZED | 0x89235208 | XBOX Live 服务未初始化。 | [XBOX Live HRESULT 错误代码 (XSAPI)](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md#xsapi) | 在调用 XBOX 服务 API 之前先调用 XblInitialize。 |
| E\_XBL\_RTA\_NOT\_ACTIVATED | 0x89235209 | 实时活动服务未激活。请调用 XblRealTimeActivityActivate 以激活实时活动服务。 | [错误查找 (xberror.exe)](https://docs.xbox.com/zh-CN/tools/tools-console/commandlinetools/xberror.md) | 实时活动服务未激活。请调用 XblRealTimeActivityActivate 以激活实时活动服务。(0x89235209) |

## 主机工具与传输

| 代码 | 值 | 说明 | 来源 | 故障排除 |
| - | - | - | - | - |
| E\_APP\_USER\_TERMINATE\_REQUEST | 0x87E1001D | 用户明确请求终止应用。 | [错误查找 (xberror.exe)](https://docs.xbox.com/zh-CN/tools/tools-console/commandlinetools/xberror.md) | 用户明确请求终止应用。(0x87E1001D) |
| E\_DSTORAGE\_XVD\_DEVICE\_NOT\_SUPPORTED | 0x89240004 | 指定的 XVD 不在受支持的 NVMe 设备上。 | [错误查找 (xberror.exe)](https://docs.xbox.com/zh-CN/tools/tools-console/commandlinetools/xberror.md) | 指定的 XVD 不在受支持的 NVMe 设备上。 |
| E\_COULD\_NOT\_CONNECT | 0x8C110303 | 无法连接到指定的开发工具包。 | [XTF 传输错误](https://docs.xbox.com/zh-CN/tools/tools-console/commandlinetools/xtf-transport-errors.md) | 无法与目标主机建立连接。请验证指定的 HostName 或 IP 地址。检查防火墙、网络设置以及能否 ping 通该主机。 |
| E\_XTFAPP\_APPLICATION\_EXITED\_BEFORE\_ACTIVATION\_COMPLETE | 0x8D160122 | 应用在完成激活之前退出或崩溃。 | [XTF 传输错误](https://docs.xbox.com/zh-CN/tools/tools-console/commandlinetools/xtf-transport-errors.md) | 无。 |
| E\_XTFAPP\_DIRECTORY\_NOT\_FOUND | 0x8D16018D | 未找到提供的目录。 | [XTF 传输错误](https://docs.xbox.com/zh-CN/tools/tools-console/commandlinetools/xtf-transport-errors.md) | 请确保该目录存在。 |

## XBOX PC 远程迭代

| 代码 | 值 | 说明 | 来源 | 故障排除 |
| - | - | - | - | - |
| E\_PROCESSNOTFOUND | 0x8C114002 | 找不到进程。请验证进程 ID 与活动的目标进程匹配。 | [XBOX PC 远程迭代 API 错误代码](https://docs.xbox.com/zh-CN/reference/remoting/error-codes.md) | 通过检查正在运行的进程列表来验证目标进程的进程 ID；提供活动进程的有效进程 ID |
| E\_INVALIDPROCESSID | 0x8C114003 | 进程 ID 无效。请提供数字形式的进程 ID。 | [XBOX PC 远程迭代 API 错误代码](https://docs.xbox.com/zh-CN/reference/remoting/error-codes.md) | 提供仅包含数字的有效进程 ID |
| E\_INVALIDPIN | 0x8C114004 | PIN 的格式不符合预期。请输入有效的 6 位 PIN。 | [XBOX PC 远程迭代 API 错误代码](https://docs.xbox.com/zh-CN/reference/remoting/error-codes.md) | 在客户端设备上输入正确的 PIN |
| E\_INVALIDSSHKEY | 0x8C114005 | SSH 密钥格式不符合预期。请使用有效的公钥并重新执行配对。 | [XBOX PC 远程迭代 API 错误代码](https://docs.xbox.com/zh-CN/reference/remoting/error-codes.md) | 生成有效的 SSH 公钥；再次执行配对，并提供有效密钥的路径 |
| E\_PAIRINGTIMEOUT | 0x8C114006 | 配对模式超过了最长时间。请重新启动配对并在 2 分钟内输入 PIN。 | [XBOX PC 远程迭代 API 错误代码](https://docs.xbox.com/zh-CN/reference/remoting/error-codes.md) | 重新启动 PIN 配对过程；在超时（2 分钟）之前在客户端设备上输入 PIN |
| E\_TOOMANYFAILURES | 0x8C114007 | PIN 尝试失败次数过多。请重新启动配对并输入正确的 PIN。 | [XBOX PC 远程迭代 API 错误代码](https://docs.xbox.com/zh-CN/reference/remoting/error-codes.md) | 重新启动 PIN 配对过程；在客户端设备上输入正确的 PIN |
| E\_CLIENTNOTAUTHORIZED | 0x8C114008 | 设备拒绝了客户端。请成功完成配对，然后重试连接。 | [XBOX PC 远程迭代 API 错误代码](https://docs.xbox.com/zh-CN/reference/remoting/error-codes.md) | 成功完成 PIN 配对过程；再次执行连接请求 |
| E\_SERVERNOTAUTHORIZED | 0x8C114009 | 客户端拒绝了设备。请成功完成配对，然后重试连接。 | [XBOX PC 远程迭代 API 错误代码](https://docs.xbox.com/zh-CN/reference/remoting/error-codes.md) | 成功完成 PIN 配对过程；再次执行连接请求 |
| E\_SSHKEYTOOLARGE | 0x8C11400A | SSH 密钥过大。请生成受支持类型/大小的密钥并使用该密钥重试。 | [XBOX PC 远程迭代 API 错误代码](https://docs.xbox.com/zh-CN/reference/remoting/error-codes.md) | 使用受支持的算法和大小生成新的 SSH 密钥（例如 ED25519 或 RSA-2048）；确保为 RIT 连接指定了正确的密钥 |
| E\_GAMENOTSUSPENDED | 0x8C11400B | 无法恢复指定的进程。请在调用 resume 之前验证该进程处于挂起状态。 | [XBOX PC 远程迭代 API 错误代码](https://docs.xbox.com/zh-CN/reference/remoting/error-codes.md) | 在恢复之前验证进程状态；确保没有其他工具已恢复或终止该进程 |
| E\_GAMENOTRUNNING | 0x8C11400C | 没有正在运行的游戏进程。请在调用游戏进程操作之前启动游戏。 | [XBOX PC 远程迭代 API 错误代码](https://docs.xbox.com/zh-CN/reference/remoting/error-codes.md) | 验证当前正在运行的进程；在使用依赖游戏进程的 API 之前启动游戏。 |
| E\_GAMEOVERSUSPENDED | 0x8C11400D | 线程挂起计数不为零。请反复恢复直到挂起计数降为零，或重新启动进程。 | [XBOX PC 远程迭代 API 错误代码](https://docs.xbox.com/zh-CN/reference/remoting/error-codes.md) | 反复恢复线程直到挂起计数降为零，或重新启动进程以重置线程状态；也可以重新启动进程以重置线程状态 |
| E\_GAMESTILLRUNNING | 0x8C11400E | 一次只能运行一个游戏。请在启动新游戏之前停止当前正在运行的游戏。 | [XBOX PC 远程迭代 API 错误代码](https://docs.xbox.com/zh-CN/reference/remoting/error-codes.md) | 确保没有之前的游戏进程在运行；在启动新游戏之前终止当前正在运行的游戏（如有）；重试启动游戏进程 |
| E\_GAMEEXITABANDONED | 0x8C11400F | 等待游戏退出的操作已放弃。请验证 PID/TID 并重试终止。 | [XBOX PC 远程迭代 API 错误代码](https://docs.xbox.com/zh-CN/reference/remoting/error-codes.md) | 检查游戏进程是否仍在运行；验证是否为终止提供了正确的进程 ID 和线程 ID；重试终止该进程 |
| E\_GAMEFILEPATHNOTEXIST | 0x8C114010 | 游戏文件路径不存在。请验证远程路径并确认部署已成功。 | [XBOX PC 远程迭代 API 错误代码](https://docs.xbox.com/zh-CN/reference/remoting/error-codes.md) | 验证该路径在远程设备上存在；确认部署已成功 |
| E\_SERVERTOOOLD | 0x8C114011 | 服务器版本对此客户端过旧。请在远程计算机上更新 `wdEndpoint`。 | [XBOX PC 远程迭代 API 错误代码](https://docs.xbox.com/zh-CN/reference/remoting/error-codes.md) | 将远程计算机上的 wdEndpoint 更新到最新版本 |
| E\_NAMERESOLUTIONFAILED | 0x8C114012 | 无法解析远程计算机名。请验证主机名和 DNS，或使用 IP 地址进行测试。 | [XBOX PC 远程迭代 API 错误代码](https://docs.xbox.com/zh-CN/reference/remoting/error-codes.md) | 验证主机名拼写、DNS 配置和网络连接；使用 IP 地址隔离名称解析问题。 |
| E\_INVALIDADDRESS | 0x8C114013 | 地址无效。请更正地址格式并使用有效的 IPv4 地址。 | [XBOX PC 远程迭代 API 错误代码](https://docs.xbox.com/zh-CN/reference/remoting/error-codes.md) | 确认正确的 IP 地址；更正地址格式并确保使用 IPv4 协议 |
| E\_CONNECTIONERROR | 0x8C114014 | 连接失败。请检查网络/防火墙/服务可用性，然后重试。 | [XBOX PC 远程迭代 API 错误代码](https://docs.xbox.com/zh-CN/reference/remoting/error-codes.md) | 检查网络连接、防火墙规则、远程计算机上的服务可用性；检查设备之间的可见性，两台设备应能互相 ping 通；在启用日志记录的情况下重试连接。 |
| E\_LISTENERALREADYRUNNING | 0x8C114015 | 另一个侦听器处于活动状态。请停止现有的终结点实例或复用它。 | [XBOX PC 远程迭代 API 错误代码](https://docs.xbox.com/zh-CN/reference/remoting/error-codes.md) | - 在启动新实例之前停止现有的终结点运行实例；或者，直接复用已在运行的终结点实例，而不是启动新实例 |
| E\_ADMIN\_REQUIRED | 0x8C114016 | 需要管理员权限。请以管理员身份运行终结点。 | [XBOX PC 远程迭代 API 错误代码](https://docs.xbox.com/zh-CN/reference/remoting/error-codes.md) | 以管理员身份重新运行终结点 |
| E\_INVALIDTHREADID | 0x8C114017 | 线程 ID 无效。请提供数字形式的线程 ID。 | [XBOX PC 远程迭代 API 错误代码](https://docs.xbox.com/zh-CN/reference/remoting/error-codes.md) | 提供仅包含数字的有效线程 ID |
| E\_INVALIDPIDTID\_PAIR | 0x8C114018 | 进程 ID 与线程 ID 不关联。请对该进程重新查询线程并重试。 | [XBOX PC 远程迭代 API 错误代码](https://docs.xbox.com/zh-CN/reference/remoting/error-codes.md) | 重新从进程中查询线程列表；确保 ID 未被缓存或过时；验证线程 ID 来自正确的进程上下文。 |
| E\_THREADNOTFOUND | 0x8C114019 | 找不到线程。请重新查询当前线程 ID，并使用非过时的 ID 重试。 | [XBOX PC 远程迭代 API 错误代码](https://docs.xbox.com/zh-CN/reference/remoting/error-codes.md) | 重新从进程中查询线程列表；确保 ID 未被缓存或过时；验证线程 ID 来自正确的进程上下文。 |

## XAPU

| 代码 | 值 | 说明 | 来源 | 故障排除 |
| - | - | - | - | - |
| XAPU\_E\_QUEUE\_FULL | 0x8AC81000 | XAPU 命令队列已满。 | [XAPU 错误](https://docs.xbox.com/zh-CN/reference/audio/xapu/enums/xapuerrors.md) | XAPU 命令队列已满。 |
| XAPU\_E\_PENDING\_RESULTS | 0x8AC81001 | 当前没有可用的结果。 | [XAPU 错误](https://docs.xbox.com/zh-CN/reference/audio/xapu/enums/xapuerrors.md) | 当前没有可用的结果。 |
| XAPU\_E\_INVALID\_COMMAND | 0x8AC81002 | 无效的 XAPU 命令值。 | [XAPU 错误](https://docs.xbox.com/zh-CN/reference/audio/xapu/enums/xapuerrors.md) | 无效的 XAPU 命令值。 |
| XAPU\_E\_INVALID\_STREAM\_INDEX | 0x8AC81003 | 提交的 XAPU 命令中流索引无效。 | [XAPU 错误](https://docs.xbox.com/zh-CN/reference/audio/xapu/enums/xapuerrors.md) | 提交的 XAPU 命令中流索引无效。 |
| XAPU\_E\_NO\_DEVICE\_RESOURCES | 0x8AC81004 | 系统资源不足以支持所请求的流数量。 | [XAPU 错误](https://docs.xbox.com/zh-CN/reference/audio/xapu/enums/xapuerrors.md) | 系统资源不足以支持所请求的流数量。 |
| XAPU\_E\_ALREADY\_ACTIVE | 0x8AC81005 | 流已处于活动状态。 | [XAPU 错误](https://docs.xbox.com/zh-CN/reference/audio/xapu/enums/xapuerrors.md) | 流已处于活动状态。 |
| XAPU\_E\_BUFFER\_TOO\_SMALL | 0x8AC81006 | 输出缓冲区太小，无法容纳数据。 | [XAPU 错误](https://docs.xbox.com/zh-CN/reference/audio/xapu/enums/xapuerrors.md) | 输出缓冲区太小，无法容纳数据。 |
| XAPU\_E\_PROCESSING\_ERROR | 0x8AC81007 | 硬件未能处理该命令。 | [XAPU 错误](https://docs.xbox.com/zh-CN/reference/audio/xapu/enums/xapuerrors.md) | 硬件未能处理该命令。 |
| XAPU\_E\_BAD\_OPUS\_PACKET | 0x8AC81008 | 硬件在解码 Opus 数据包时遇到错误。请检查编码是否存在错误。 | [XAPU 错误](https://docs.xbox.com/zh-CN/reference/audio/xapu/enums/xapuerrors.md) | 硬件在解码 Opus 数据包时遇到错误。请检查编码是否存在错误。 |
| XAPU\_E\_DEVICE\_FAULT | 0x8AC81050 | 发生了不可恢复的固件崩溃。 | [XAPU 错误](https://docs.xbox.com/zh-CN/reference/audio/xapu/enums/xapuerrors.md) | 发生了不可恢复的固件崩溃。 |
| XAPU\_E\_DEVICE\_TIMEOUT | 0x8AC81051 | 硬件未及时响应。 | [XAPU 错误](https://docs.xbox.com/zh-CN/reference/audio/xapu/enums/xapuerrors.md) | 硬件未及时响应。 |
| XAPU\_E\_DEVICE\_FATAL\_ERROR | 0x8AC81052 | 硬件遇到错误，需要重新建立连接。 | [XAPU 错误](https://docs.xbox.com/zh-CN/reference/audio/xapu/enums/xapuerrors.md) | 硬件遇到错误，需要重新建立连接。 |

## XDSP

| 代码 | 值 | 说明 | 来源 | 故障排除 |
| - | - | - | - | - |
| XDSP\_E\_QUEUE\_FULL | 0x8AC810A0 | 命令队列已满。请等待足够的时间让硬件完成对已提交命令的处理，然后再提交更多命令。 | [XDSP 错误](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/enums/xdsperrors.md) | 命令队列已满。请等待足够的时间让硬件完成对已提交命令的处理，然后再提交更多命令。 |
| XDSP\_E\_PENDING\_RESULTS | 0x8AC810A1 | 在收到所有已提交命令的结果之前，XDspStream 就已停用。请等待足够的时间让硬件完成对流的已提交命令的处理，然后再停用该流。 | [XDSP 错误](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/enums/xdsperrors.md) | 在收到所有已提交命令的结果之前，XDspStream 就已停用。请等待足够的时间让硬件完成对流的已提交命令的处理，然后再停用该流。 |
| XDSP\_E\_NO\_DEVICE\_RESOURCES | 0x8AC810A2 | 没有可用的 XDSP 设备资源来处理你的请求。 | [XDSP 错误](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/enums/xdsperrors.md) | 没有可用的 XDSP 设备资源来处理你的请求。 |
| XDSP\_E\_DEVICE\_FATAL\_ERROR | 0x8AC810A3 | 当前处理的命令发生了致命错误（例如崩溃/挂起）。请查看 [XDspStatus](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/structs/xdspstatus.md) 结构以了解哪个命令序列失败。硬件具有自动恢复机制，允许后续命令继续得到处理。 | [XDSP 错误](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/enums/xdsperrors.md) | 当前处理的命令发生了致命错误（例如崩溃/挂起）。请查看 [XDspStatus](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/structs/xdspstatus.md) 结构以了解哪个命令序列失败。硬件具有自动恢复机制，允许后续命令继续得到处理。 |
| XDSP\_E\_NOT\_ALL\_HANDLES\_DEACTIVATED | 0x8AC810A4 | 在与客户端关联的所有 XDspStream 对象停用之前，就对 XDspClient 调用了 [XDspDisconnect](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/functions/xdspdisconnect.md)。 | [XDSP 错误](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/enums/xdsperrors.md) | 在与客户端关联的所有 XDspStream 对象停用之前，就对 XDspClient 调用了 [XDspDisconnect](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/functions/xdspdisconnect.md)。 |
| XDSP\_E\_MAX\_CLIENTS\_EXCEEDED | 0x8AC810A5 | 已创建的 XDspClient 数量达到上限。 | [XDSP 错误](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/enums/xdsperrors.md) | 已创建的 XDspClient 数量达到上限。 |
| XDSP\_E\_MAX\_AGGREGATE\_IMPULSE\_RESPONSE\_EXCEEDED | 0x8AC810A6 | 当前的 [XDspConnect](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/functions/xdspconnect.md) 调用会导致 XDSP 超出所支持的最大聚合脉冲响应长度，因此无效。 | [XDSP 错误](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/enums/xdsperrors.md) | 当前的 [XDspConnect](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/functions/xdspconnect.md) 调用会导致 XDSP 超出所支持的最大聚合脉冲响应长度，因此无效。 |
| XDSP\_E\_INVALID\_IMPULSE\_RESPONSE\_LENGTH | 0x8AC810A7 | 对 [XDspActivate](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/functions/xdspactivate.md) 的调用使用了过大或过小的脉冲响应长度。 | [XDSP 错误](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/enums/xdsperrors.md) | 对 [XDspActivate](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/functions/xdspactivate.md) 的调用使用了过大或过小的脉冲响应长度。 |


## Related topics

- [Xbox Live HRESULT 错误代码](https://docs.xbox.com/zh-CN/reference/live/xbl-hresult-error-codes.md)
- [全局 API 方法错误代码](https://docs.xbox.com/zh-CN/services/playfab/api-references/global-api-method-error-codes.md)
- [PlayFab Party 错误代码](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/partyerrors.md)
- [PlayFab Multiplayer C++ SDK 错误代码](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayererrors.md)
- [XBOX PC 远程迭代 API 错误代码](https://docs.xbox.com/zh-CN/reference/remoting/error-codes.md)