> ## 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.

# XBOX PC 远程迭代 API 错误代码

> XBOX PC 远程迭代 API 返回的 HRESULT 错误代码参考列表，每个代码均附有根本原因与故障排查说明。

# XBOX PC 远程迭代 API 错误代码

下表列出了 XBOX PC 远程迭代 API 特有的所有错误代码。这些错误代码作为 `HRESULT` 值由 API 函数返回。除了这些 API 特定的代码之外，函数还可能返回标准的 `HRESULT` 值，例如 `E_INVALIDARG` 或 `E_OUTOFMEMORY`。

| 错误名称 | 十六进制值 | 描述 | 根本原因 | 故障排除 |
| - | - | - | - | - |
| E\_PROCESSNOTFOUND | 0x8C114002 | 未找到进程。 | 不存在与所提供的进程 ID 匹配的进程 | 通过查看正在运行的进程列表来核实目标进程的进程 ID；提供活动进程的有效进程 ID |
| E\_INVALIDPROCESSID | 0x8C114003 | 无效的进程 ID。 | 提供的进程 ID 不符合强制要求的格式，它必须是数字值 | 提供仅包含数字的有效进程 ID |
| E\_INVALIDPIN | 0x8C114004 | PIN 码格式不正确。 | 提供的 PIN 码不符合强制要求的格式，例如长度超过或短于 6 个字符，或使用了不受支持的 Unicode 字符 | 在客户端设备上输入正确的 PIN 码 |
| E\_INVALIDSSHKEY | 0x8C114005 | SSH 密钥不是预期的形式。 | 提供的 SSH 密钥字段不符合预期格式：密钥类型 - Base64 编码的公钥 - 注释 | 生成一个有效的 SSH 公钥；再次执行配对并提供有效密钥的路径 |
| E\_PAIRINGTIMEOUT | 0x8C114006 | 配对模式超过最长时间。 | 如果完成 PIN 配对所需的时间超过 2 分钟，用户将看到此错误 | 重新启动 PIN 配对过程；在超时（2 分钟）之前在客户端设备上输入 PIN 码 |
| E\_TOOMANYFAILURES | 0x8C114007 | PIN 尝试失败次数过多。 | 如果用户未能正确输入 PIN 码达 3 次或更多次，将看到此错误 | 重新启动 PIN 配对过程；在客户端设备上输入正确的 PIN 码 |
| E\_CLIENTNOTAUTHORIZED | 0x8C114008 | 设备拒绝了客户端。 | 该客户端不在设备的受信任客户端列表中。在完成配对过程之前就发起了连接尝试 | 成功完成 PIN 配对过程；再次执行连接请求 |
| E\_SERVERNOTAUTHORIZED | 0x8C114009 | 客户端拒绝了设备。 | 目标设备不在客户端的受信任端点列表中。在完成配对过程之前就发起了连接尝试 | 成功完成 PIN 配对过程；再次执行连接请求 |
| E\_SSHKEYTOOLARGE | 0x8C11400A | SSH 密钥过大。 | 提供的 SSH 密钥文件超出端点支持的 16,384 字节大小（通常是由于旧版 RSA 密钥或格式不正确的密钥数据）。 | 使用受支持的算法和大小（例如 ED25519 或 RSA‑2048）生成新的 SSH 密钥；确保为 RIT 连接指定了正确的密钥 |
| E\_GAMENOTSUSPENDED | 0x8C11400B | 无法恢复指定的进程。 | 尝试恢复未处于挂起状态或其挂起上下文不再有效的进程。 | 在恢复之前核实进程状态；确保没有其他工具已经恢复或终止该进程 |
| E\_GAMEOVERSUSPENDED | 0x8C11400D | 线程挂起计数不为零。 | 线程已被多次挂起且尚未完全恢复。Windows 线程挂起语义要求恢复调用次数相匹配。 | 反复恢复线程直到挂起计数达到零，或重启进程以重置线程状态；也可以重启进程以重置线程状态 |
| E\_GAMESTILLRUNNING | 0x8C11400E | 一次只能运行一款游戏。 | 当已有注册为游戏的进程正在运行时，尝试启动新进程。RIT 强制单一活动游戏进程以支持一次一款游戏 (OGAT) 设置 | 确保没有先前的游戏进程正在运行；在启动另一款游戏之前，终止当前正在运行的游戏（如果有）；重试启动游戏进程 |
| E\_GAMEEXITABANDONED | 0x8C11400F | 已放弃等待游戏退出。 | 游戏进程终止挂起，且未返回退出代码 | 检查游戏进程是否仍在运行；核实是否为终止操作提供了正确的进程 ID 和线程 ID；重试终止进程 |
| E\_GAMEFILEPATHNOTEXIST | 0x8C114010 | 游戏文件路径不存在。 | 提供的游戏可执行文件或包路径在远程计算机上无效或无法访问。 | 验证该路径在远程设备上存在；确认部署成功 |
| E\_SERVERTOOOLD | 0x8C114011 | 服务器版本对此客户端来说过旧。 | 客户端的 API 版本比远程设备上的端点版本更新 | 将远程计算机上的 wdEndpoint 更新到最新版本 |
| E\_NAMERESOLUTIONFAILED | 0x8C114012 | 无法解析远程计算机名称。 | 无法通过 DNS 或本地名称解析来解析主机名。 | 核实主机名拼写、DNS 配置和网络连接；使用 IP 地址以隔离名称解析问题。 |
| E\_INVALIDADDRESS | 0x8C114013 | 无效地址。 | 提供了不正确、格式错误或不支持的网络地址（例如，错误的 IP 格式、错误的 IP 或不支持的协议）。 | 确认 IP 地址正确；更正地址格式，并确保使用 IPv4 协议 |
| E\_CONNECTIONERROR | 0x8C114014 | 连接错误。 | 建立网络连接时发生一般性失败（传输层失败），与 IP 地址有效性或远程计算机名称解析无关 | 检查网络连接、防火墙规则、远程计算机上的服务可用性；检查设备之间的可见性，它们应能够相互 ping 通；启用日志记录后重试连接。 |
| E\_LISTENERALREADYRUNNING | 0x8C114015 | 另一个侦听器处于活动状态。 | 远程设备上已经有另一个端点实例正在运行 | - 在启动新实例之前，停止现有正在运行的端点实例；或者，使用已在运行的端点实例而不是启动新实例 |
| E\_ADMIN\_REQUIRED | 0x8C114016 | 需要管理员权限。 | 端点未以提升的权限运行，而操作需要管理员级别的权限 | 以管理员身份重新运行端点 |
| E\_INVALIDTHREADID | 0x8C114017 | 无效的线程 ID。 | 提供的线程 ID 不符合预期格式，它必须是数字值 | 提供仅包含数字的有效线程 ID |
| E\_INVALIDPIDTID\_PAIR | 0x8C114018 | 给定的进程 ID 与给定的线程 ID 不关联。 | 线程 ID 存在，但不属于指定的进程。 | 从该进程重新查询线程列表；确保 ID 未被缓存或已过时；验证线程 ID 是否从正确的进程上下文中获取。 |
| E\_THREADNOTFOUND | 0x8C114019 | 未找到线程。 | 提供的线程 ID 不对应目标进程中任何现有的线程。线程可能已经退出，或者从未有效过。 | 从该进程重新查询线程列表；确保 ID 未被缓存或已过时；验证线程 ID 是否从正确的进程上下文中获取。 |

## 另请参阅

* [XBOX PC 远程迭代 API](https://docs.xbox.com/zh-CN/reference/remoting/remoteiteration_members.md)


## Related topics

- [错误代码](https://docs.xbox.com/zh-CN/reference/errorcodes.md)
- [WdRegisterRemoteXboxGame](https://docs.xbox.com/zh-CN/reference/remoting/functions/wdregisterremotexboxgame.md)
- [WdTerminateRemoteGame](https://docs.xbox.com/zh-CN/reference/remoting/functions/wdterminateremotegame.md)
- [WdResumeRemoteGame](https://docs.xbox.com/zh-CN/reference/remoting/functions/wdresumeremotegame.md)
- [WdLaunchRemoteGame](https://docs.xbox.com/zh-CN/reference/remoting/functions/wdlaunchremotegame.md)