XBOX PC Remote Iteration API 錯誤碼
下表列出 XBOX PC Remote Iteration API 特有的所有錯誤碼。這些錯誤碼會以HRESULT 值的形式從 API 函式傳回。除了這些 API 特有的錯誤碼之外，函式也可能傳回 E_INVALIDARG 或 E_OUTOFMEMORY 等標準 HRESULT 值。
| 錯誤名稱 | 十六進位值 | 描述 | 根本原因 | 疑難排解 |
|---|---|---|---|---|
| E_OUTSIDEGAMEROOT | 0x8C114001 | 路徑位於 GameRoot 之外；存取遭拒。 | 相對路徑解析到允許的通用根目錄之外，或找不到指定的通用根目錄別名 | 使用會解析到通用根目錄內的路徑；確認遠端裝置上存在該通用根目錄別名 |
| E_PROCESSNOTFOUND | 0x8C114002 | 找不到處理序。 | 不存在符合所提供處理序識別碼的處理序 | 檢查執行中處理序的清單，以確認目標處理序的處理序識別碼；提供作用中處理序的有效處理序識別碼 |
| E_INVALIDPROCESSID | 0x8C114003 | 處理序識別碼無效。 | 提供的處理序識別碼不符合強制格式，必須是數值 | 提供只包含數字的有效處理序識別碼 |
| E_INVALIDPIN | 0x8C114004 | PIN 格式不正確。 | 提供的 PIN 不符合強制格式，例如長於或短於 6 個字元，或使用不支援的 Unicode 字元 | 在用戶端裝置上輸入正確的 PIN |
| E_INVALIDSSHKEY | 0x8C114005 | SSH 金鑰不是預期的格式。 | 提供的 SSH 金鑰欄位不符合預期格式：金鑰類型 - Base64 編碼的公開金鑰 - 註解 | 產生有效的 SSH 公開金鑰；提供有效金鑰的路徑並再次執行配對 |
| E_PAIRINGTIMEOUT | 0x8C114006 | 配對模式超過時間上限。 | 如果使用者花費超過 2 分鐘才完成 PIN 配對，就會看到此錯誤 | 重新啟動 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 金鑰或格式不正確的金鑰 Blob)。 | 使用支援的演算法和大小 (例如 ED25519 或 RSA‑2048) 產生新的 SSH 金鑰；確定為 RIT 連線指定了正確的金鑰 |
| E_GAMENOTSUSPENDED | 0x8C11400B | 無法繼續指定的處理序。 | 嘗試繼續一個不處於暫停狀態，或其暫停內容已不再有效的處理序。 | 在繼續之前確認處理序狀態；確定沒有其他工具已繼續或終止該處理序 |
| E_GAMEOVERSUSPENDED | 0x8C11400D | 執行緒暫停計數不為零。 | 執行緒已被暫停多次，且尚未完全繼續。Windows 執行緒暫停語意要求繼續呼叫的次數必須對等。 | 重複繼續執行緒直到暫停計數達到零，或重新啟動處理序以重設執行緒狀態。；或者重新啟動處理序以重設執行緒狀態 |
| E_GAMESTILLRUNNING | 0x8C11400E | 一次只能執行一個遊戲。 | 在已有註冊為遊戲的處理序執行時，嘗試啟動新的處理序。RIT 強制只能有一個作用中的遊戲處理序，以支援一次一個遊戲 (OGAT) 設定 | 確定沒有先前的遊戲處理序正在執行；在啟動另一個遊戲之前，終止目前執行中的遊戲 (如果有的話)；重試啟動遊戲處理序 |
| E_GAMEEXITABANDONED | 0x8C11400F | 已放棄等候遊戲結束。 | 遊戲處理序終止時停止回應，且未傳回結束代碼 | 檢查遊戲處理序是否仍在執行；確認提供了正確的處理序識別碼和執行緒識別碼以進行終止；重試終止處理序 |
| 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 | 執行緒識別碼無效。 | 提供的執行緒識別碼不符合預期格式，必須是數值 | 提供只包含數字的有效執行緒識別碼 |
| E_INVALIDPIDTID_PAIR | 0x8C114018 | 指定的處理序識別碼與指定的執行緒識別碼沒有關聯。 | 執行緒識別碼存在，但不屬於指定的處理序。 | 重新從處理序查詢執行緒清單；確定識別碼未經快取或已過時。；驗證執行緒識別碼是從正確的處理序內容取得。 |
| E_THREADNOTFOUND | 0x8C114019 | 找不到執行緒。 | 提供的執行緒識別碼不對應目標處理序中任何現有的執行緒。執行緒可能已結束或從未有效。 | 重新從處理序查詢執行緒清單；確定識別碼未經快取或已過時。；驗證執行緒識別碼是從正確的處理序內容取得。 |