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가 올바른 프로세스 컨텍스트에서 얻어졌는지 검증하세요. |