> ## 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 오류 코드

> XBOX PC Remote Iteration API에서 반환되는 HRESULT 오류 코드의 참조 목록으로, 각 코드에 대한 근본 원인과 문제 해결 참고 사항이 포함되어 있습니다.

# XBOX PC 원격 반복 API 오류 코드

다음 표에는 XBOX PC 원격 반복 API 전용 오류 코드가 모두 나열되어 있습니다. 이러한 오류 코드는 API 함수에서 `HRESULT` 값으로 반환됩니다. 이러한 API 전용 코드 외에도, 함수는 `E_INVALIDARG` 또는 `E_OUTOFMEMORY`와 같은 표준 `HRESULT` 값을 반환할 수도 있습니다.

| 오류 이름                     | 16진수 값     | 설명                                     | 근본 원인                                                                                                     | 문제 해결                                                                                                      |
| ------------------------- | ---------- | -------------------------------------- | --------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| E\_PROCESSNOTFOUND        | 0x8C114002 | 프로세스를 찾을 수 없습니다.                       | 제공된 프로세스 ID와 일치하는 프로세스가 존재하지 않습니다.                                                                        | 실행 중인 프로세스 목록을 확인하여 대상 프로세스의 프로세스 ID를 검증하세요; 활성 프로세스의 유효한 프로세스 ID를 제공하세요.                                  |
| E\_INVALIDPROCESSID       | 0x8C114003 | 유효하지 않은 프로세스 ID.                       | 제공된 프로세스 ID가 지정된 형식을 따르지 않습니다. 반드시 숫자 값이어야 합니다.                                                           | 숫자만 포함된 유효한 프로세스 ID를 제공하세요.                                                                                |
| E\_INVALIDPIN             | 0x8C114004 | PIN이 올바른 형식이 아닙니다.                     | 제공된 PIN이 지정된 형식을 따르지 않습니다. 예를 들어 길이가 6자보다 길거나 짧거나, 지원되지 않는 유니코드 문자를 사용한 경우입니다.                            | 클라이언트 장치에 올바른 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 | 스레드 일시 중단 카운트가 0이 아닙니다.                | 스레드가 여러 번 일시 중단되었으며 완전히 재개되지 않았습니다. Windows 스레드 일시 중단 의미론은 재개 호출이 균형을 이루어야 합니다.                           | 일시 중단 카운트가 0에 도달할 때까지 스레드를 반복적으로 재개하거나, 프로세스를 다시 시작하여 스레드 상태를 재설정하세요; 또는 프로세스를 다시 시작하여 스레드 상태를 재설정하세요.     |
| 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](/reference/remoting/remoteiteration_members)


## Related topics

- [오류 코드](/ko/reference/errorcodes.md)
- [XBOX PC Remote Iteration API](/ko/reference/remoting/remoteiteration_members.md)
- [WdRegisterRemoteXboxGame](/ko/reference/remoting/functions/wdregisterremotexboxgame.md)
- [WdTerminateRemoteGame](/ko/reference/remoting/functions/wdterminateremotegame.md)
- [WdResumeRemoteGame](/ko/reference/remoting/functions/wdresumeremotegame.md)
