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

# XBOX PC Remote Iteration API error codes

> Reference list of HRESULT error codes returned by the XBOX PC Remote Iteration API, with root causes and troubleshooting notes for each code.

# XBOX PC Remote Iteration API Error Codes

The following table lists all error codes specific to the XBOX PC Remote Iteration API. These error codes are returned as `HRESULT` values from API functions. In addition to these API-specific codes, functions may also return standard `HRESULT` values such as `E_INVALIDARG` or `E_OUTOFMEMORY`.

| Error Name                | Hex Value  | Description                                              | Root Cause                                                                                                                                                                     | Troubleshooting                                                                                                                                                                                              |
| ------------------------- | ---------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| E\_PROCESSNOTFOUND        | 0x8C114002 | Process not found.                                       | A process matching the process id provided does not exist                                                                                                                      | Verify the process id of the target process by checking the list of running processes; Provide a valid process id of an active process                                                                       |
| E\_INVALIDPROCESSID       | 0x8C114003 | Invalid process ID.                                      | The process id provided does not follow the enforced format, it must be a numerical value                                                                                      | Provide a valid process id containing only numbers                                                                                                                                                           |
| E\_INVALIDPIN             | 0x8C114004 | Pin is not in proper format.                             | The pin provided does not follow the enforced format, such as making it longer or shorter than 6 characters, or using unsupported unicode characters                           | Input the correct pin on the client device                                                                                                                                                                   |
| E\_INVALIDSSHKEY          | 0x8C114005 | SSH key is not in expected form.                         | The provided SSH Key field does not follow the expected format: key type - Base64 encoded public key - comment                                                                 | Generate a valid SSH public key; Execute the pairing again providing the path to the valid key                                                                                                               |
| E\_PAIRINGTIMEOUT         | 0x8C114006 | Pair mode exceeded maximum time.                         | User will see this if taking more than 2 minutes to complete the pin pairing                                                                                                   | Restart pin pairing process; Input pin on client device before timeout (2 min)                                                                                                                               |
| E\_TOOMANYFAILURES        | 0x8C114007 | Too many failed PIN attempts.                            | User will see this if they have failed to input the correct pin 3 times or more                                                                                                | Restart pin pairing process; Input correct pin on client device                                                                                                                                              |
| E\_CLIENTNOTAUTHORIZED    | 0x8C114008 | Device rejected client.                                  | The client is not on the list of trusted clients of the device. Connection attempt was started before completing the pairing process                                           | Complete pin pairing process successfully; Execute the connection request again                                                                                                                              |
| E\_SERVERNOTAUTHORIZED    | 0x8C114009 | Client rejected device.                                  | The target device is not on the list of trusted endpoints of the client. Connection attempt was started before completing the pairing process                                  | Complete pin pairing process successfully; Execute the connection request again                                                                                                                              |
| E\_SSHKEYTOOLARGE         | 0x8C11400A | SSH key too large.                                       | SSH key file provided exceeds endpoint-supported size of 16,384 bytes (commonly due to legacy RSA keys or malformed key blobs).                                                | Generate a new SSH key using a supported algorithm and size (e.g., ED25519 or RSA‑2048); Ensure the correct key is specified for the RIT connection                                                          |
| E\_GAMENOTSUSPENDED       | 0x8C11400B | Specified process cannot be resumed.                     | Attempt to resume a process that is not in a suspended state or whose suspend context is no longer valid.                                                                      | Verify the process state before resuming; Ensure no other tool has already resumed or terminated the process                                                                                                 |
| E\_GAMEOVERSUSPENDED      | 0x8C11400D | The thread suspend count is not zero.                    | Thread has been suspended multiple times and has not been fully resumed. Windows thread suspend semantics require balanced resume calls.                                       | Resume the thread repeatedly until suspend count reaches zero, or restart the process to reset thread state; Alternatively restart the process to reset thread state                                         |
| E\_GAMESTILLRUNNING       | 0x8C11400E | Only one game may run at a time.                         | Attempt to launch a new process when a process registered as a game is already running. RIT enforces a single active game process to support one game at a time (OGAT) setting | Ensure there is no previous game process running; Terminate the currently running game (if any) before launching another; Retry launching the game process                                                   |
| E\_GAMEEXITABANDONED      | 0x8C11400F | Abandoned wait for game to exit.                         | Game process termination hung and there was no exit code returned                                                                                                              | Check if the game process is still running; Verify if the right process id and thread id were provided for termination; Retry to terminate the process                                                       |
| E\_GAMEFILEPATHNOTEXIST   | 0x8C114010 | Game file path does not exist.                           | Provided game executable or package path is invalid or inaccessible on the remote machine.                                                                                     | Validate the path exists on the remote device; Confirm deployment succeeded                                                                                                                                  |
| E\_SERVERTOOOLD           | 0x8C114011 | The server version is too old for this client.           | API version on the client side is newer than the endpoint version on the remote device                                                                                         | Update the wdEndpoint on the remote machine to the latest version                                                                                                                                            |
| E\_NAMERESOLUTIONFAILED   | 0x8C114012 | Could not resolve the remote machine name.               | Hostname cannot be resolved via DNS or local name resolution.                                                                                                                  | Verify hostname spelling, DNS configuration, and network connectivity; Use IP address to isolate name resolution issues.                                                                                     |
| E\_INVALIDADDRESS         | 0x8C114013 | Invalid address.                                         | Incorrect, malformed or unsupported network address supplied (e.g., bad IP format, wrong IP or unsupported protocol).                                                          | Confirm the right IP address; Correct the address format and ensure it uses an IPv4 protocol                                                                                                                 |
| E\_CONNECTIONERROR        | 0x8C114014 | Connection error.                                        | Generic failure when establishing the network connection (transport‑level failure), unrelated to ip address validity or remote machine name resolution                         | Check network connectivity, firewall rules, service availability on the remote machine; Check visibility between devices, they should be able to ping each other; Retry the connection with logging enabled. |
| E\_LISTENERALREADYRUNNING | 0x8C114015 | Another listener is active.                              | Another instance of the endpoint is already running on the remote device                                                                                                       | - Stop the existing running instance of the endpoint before launching a new one; Alternatively, use the instance of the endpoint already running instead of launching a new one                              |
| E\_ADMIN\_REQUIRED        | 0x8C114016 | Administrator privileges required.                       | Endpoint is not running with elevated privileges and the operation requires Administrator level permissions                                                                    | Re-run the endpoint as Administrator                                                                                                                                                                         |
| E\_INVALIDTHREADID        | 0x8C114017 | Invalid thread ID.                                       | Thread ID provided does not follow the expected format, it must be a numerical value                                                                                           | Provide a valid thread id containing only numbers                                                                                                                                                            |
| E\_INVALIDPIDTID\_PAIR    | 0x8C114018 | Given process ID is not associated with given thread ID. | Thread ID exists, but it does not belong to the specified process.                                                                                                             | Re‑query thread list from the process; Ensure IDs are not cached or stale; Validate that the thread ID was obtained from the correct process context.                                                        |
| E\_THREADNOTFOUND         | 0x8C114019 | Thread not found.                                        | Provided thread ID does not correspond to any existing thread in the target process. Thread may have already exited or was never valid.                                        | Re‑query thread list from the process; Ensure IDs are not cached or stale; Validate that the thread ID was obtained from the correct process context.                                                        |

## See also

* [XBOX PC Remote Iteration API](/reference/remoting/remoteiteration_members)


## Related topics

- [Error codes](/reference/errorcodes.md)
- [XBOX PC Remote Iteration API](/reference/remoting/remoteiteration_members.md)
- [WdRegisterRemoteXboxGame](/reference/remoting/functions/wdregisterremotexboxgame.md)
- [WdTerminateRemoteGame](/reference/remoting/functions/wdterminateremotegame.md)
- [WdResumeRemoteGame](/reference/remoting/functions/wdresumeremotegame.md)
