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

# 오류 코드

> XGameErr.h에 선언된 GDK 오류 코드 상수로, 하위 시스템별로 정리되어 있으며 XBOX 및 PC 개발자가 조회할 수 있도록 HRESULT 값이 숫자순으로 정렬되어 있습니다.

XGameErr.h에 선언된 Microsoft Game Development Kit(GDK) 오류 코드 값의 상수 정의입니다.

이 개요는 하위 시스템별로 구성되어 있으며, 각 표는 숫자 조회가 쉽도록 `HRESULT` 값의 오름차순으로 정렬되어 있습니다.

시작, 배포 및 진단 도구 시나리오를 포함한 포괄적인 도구 및 플랫폼 `HRESULT` 정보는 [오류 조회(xberror.exe)](/tools/tools-console/commandlinetools/xberror)를 참조하세요.

## 게임 런타임

| 코드                                           | 값          | 설명                                                        | 출처                                                                                                      | 문제 해결                                             |
| -------------------------------------------- | ---------- | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------- |
| E\_GAME\_MISSING\_GAME\_CONFIG               | 0x87E5001F | 이 앱에는 필수 MicrosoftGame.Config 파일이 없습니다.                   | [MicrosoftGame.config 요소 참조](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc) | 패키지에 유효한 MicrosoftGame.config를 추가한 후 다시 빌드/배포하세요. |
| E\_GAMERUNTIME\_NOT\_INITIALIZED             | 0x89240100 | 게임 런타임이 초기화되지 않았습니다.                                      | [XGameRuntime](/reference/system/xgameruntimeinit/xgameruntimeinit_members)                             | 런타임 초기화/해제 순서, 패키지 호환성, 앱 상태를 확인한 후 다시 시도하세요.     |
| E\_GAMERUNTIME\_DLL\_NOT\_FOUND              | 0x89240101 | 게임 런타임 DLL을 찾을 수 없습니다.                                    | [XGameRuntime](/reference/system/xgameruntimeinit/xgameruntimeinit_members)                             | 런타임 초기화/해제 순서, 패키지 호환성, 앱 상태를 확인한 후 다시 시도하세요.     |
| E\_GAMERUNTIME\_VERSION\_MISMATCH            | 0x89240102 | 게임 런타임 DLL이 이 버전의 GDK를 지원하지 않습니다.                         | [XGameRuntime](/reference/system/xgameruntimeinit/xgameruntimeinit_members)                             | 런타임 초기화/해제 순서, 패키지 호환성, 앱 상태를 확인한 후 다시 시도하세요.     |
| E\_GAMERUNTIME\_WINDOW\_NOT\_FOREGROUND      | 0x89240103 | 이 작업을 수행하려면 애플리케이션 창이 전경에 있어야 합니다.                        |                                                                                                         | 앱 창을 전경으로 가져온 후 작업을 다시 시도하세요.                     |
| E\_GAMERUNTIME\_SUSPENDED                    | 0x89240104 | 게임 런타임이 일시 중단된 상태입니다.                                     | [XBOX 게임 수명 주기](/build/console-features/console-workflows/xbox-game-life-cycle)                         | 런타임 초기화/해제 순서, 패키지 호환성, 앱 상태를 확인한 후 다시 시도하세요.     |
| E\_GAMERUNTIME\_UNINITIALIZE\_ACTIVEOBJECTS  | 0x89240105 | XGameRuntimeUninitialize 시점에 게임 런타임에 활성 객체가 남아 있습니다.      | [XGameRuntimeUninitialize](/reference/system/xgameruntimeinit/functions/xgameruntimeuninitialize)       | 런타임 초기화/해제 순서, 패키지 호환성, 앱 상태를 확인한 후 다시 시도하세요.     |
| E\_GAMERUNTIME\_MULTIPLAYER\_NOT\_CONFIGURED | 0x89240106 | 이 타이틀에서 해당 사용자에 대해 서비스에 설정된 멀티플레이어 활동이 없습니다.              | [XBOX Services 멀티플레이어](/services/xbox-services/multiplayer/overviews/live-multiplayer-intro)            | 런타임 초기화/해제 순서, 패키지 호환성, 앱 상태를 확인한 후 다시 시도하세요.     |
| E\_GAMERUNTIME\_OPTIONS\_MISMATCH            | 0x89240109 | 런타임이 이미 다른 옵션 집합으로 초기화되었습니다. 새 옵션으로 다시 초기화하기 전에 먼저 해제하세요. | [XGameRuntimeUninitialize](/reference/system/xgameruntimeinit/functions/xgameruntimeuninitialize)       | 런타임 초기화/해제 순서, 패키지 호환성, 앱 상태를 확인한 후 다시 시도하세요.     |
| E\_GAMERUNTIME\_OPTIONS\_NOT\_SUPPORTED      | 0x8924010A | 전달된 옵션이 게임의 패키지와 호환되지 않습니다. 게임 구성 정보는 패키지와 일치해야 합니다.      | [MicrosoftGame.config 요소 참조](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc) | 런타임 초기화/해제 순서, 패키지 호환성, 앱 상태를 확인한 후 다시 시도하세요.     |
| E\_GAMERUNTIME\_GAMECONFIG\_BAD\_FORMAT      | 0x8924010B | Initialize에 전달된 게임 구성을 구문 분석할 수 없습니다.                     | [MicrosoftGame.config 요소 참조](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc) | 런타임 초기화/해제 순서, 패키지 호환성, 앱 상태를 확인한 후 다시 시도하세요.     |
| E\_GAMERUNTIME\_INVALID\_HANDLE              | 0x8924010C | 핸들은 런타임 초기화 간에 사용할 수 없습니다.                                |                                                                                                         | 런타임 초기화/해제 순서, 패키지 호환성, 앱 상태를 확인한 후 다시 시도하세요.     |

## 게임 사용자

| 코드                                                | 값          | 설명                                                                             | 출처                                                                                                      | 문제 해결                                         |
| ------------------------------------------------- | ---------- | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------- | --------------------------------------------- |
| E\_GAMEUSER\_MAX\_USERS\_ADDED                    | 0x89245100 | 최대 사용자 수에 도달하여 이 사용자를 추가할 수 없습니다.                                              | [XUserAddAsync](/reference/system/xuser/functions/xuseraddasync)                                        | 로그인/기본 사용자/타이틀 ID 구성을 확인한 후 사용자 흐름을 다시 시도하세요. |
| E\_GAMEUSER\_SIGNED\_OUT                          | 0x89245101 | 사용자가 로그아웃된 상태이므로 작업을 수행할 수 없습니다.                                               | [XUserAddAsync](/reference/system/xuser/functions/xuseraddasync)                                        | 로그인/기본 사용자/타이틀 ID 구성을 확인한 후 사용자 흐름을 다시 시도하세요. |
| E\_GAMEUSER\_RESOLVE\_USER\_ISSUE\_REQUIRED       | 0x89245102 | 이 사용자의 문제를 해결하려면 UI가 필요합니다.                                                    | [XUserResolveIssueWithUiAsync](/reference/system/xuser/functions/xuserresolveissuewithuiasync)          | 로그인/기본 사용자/타이틀 ID 구성을 확인한 후 사용자 흐름을 다시 시도하세요. |
| E\_GAMEUSER\_DEFERRAL\_NOT\_AVAILABLE             | 0x89245103 | 지금은 지연 요청을 할 수 있는 시점이 아닙니다.                                                    | [XUserGetTokenAndSignatureAsync](/reference/system/xuser/functions/xusergettokenandsignatureasync)      | 로그인/기본 사용자/타이틀 ID 구성을 확인한 후 사용자 흐름을 다시 시도하세요. |
| E\_GAMEUSER\_USER\_NOT\_FOUND                     | 0x89245104 | 해당 ID와 일치하는 사용자를 찾을 수 없습니다.                                                    |                                                                                                         | 로그인/기본 사용자/타이틀 ID 구성을 확인한 후 사용자 흐름을 다시 시도하세요. |
| E\_GAMEUSER\_NO\_TOKEN\_REQUIRED                  | 0x89245105 | 이 호출에는 토큰이 필요하지 않습니다.                                                          |                                                                                                         | 로그인/기본 사용자/타이틀 ID 구성을 확인한 후 사용자 흐름을 다시 시도하세요. |
| E\_GAMEUSER\_NO\_DEFAULT\_USER                    | 0x89245106 | 현재 기본 사용자가 없습니다. 이 오류가 발생하면 AddDefaultUserSilently 없이 XUserAddAsync를 다시 호출하세요. | [XUserAddAsync](/reference/system/xuser/functions/xuseraddasync)                                        | 로그인/기본 사용자/타이틀 ID 구성을 확인한 후 사용자 흐름을 다시 시도하세요. |
| E\_GAMEUSER\_FAILED\_TO\_RESOLVE                  | 0x89245107 | 지정된 권한을 확인하지 못했습니다.                                                            |                                                                                                         | 로그인/기본 사용자/타이틀 ID 구성을 확인한 후 사용자 흐름을 다시 시도하세요. |
| E\_GAMEUSER\_NO\_TITLE\_ID                        | 0x89245108 | XBOX Live TitleId를 구성해야 합니다.                                                   | [MicrosoftGame.config 요소 참조](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc) | 로그인/기본 사용자/타이틀 ID 구성을 확인한 후 사용자 흐름을 다시 시도하세요. |
| E\_GAMEUSER\_UNKNOWN\_GAME\_IDENTITY              | 0x89245109 | 게임 ID를 인식할 수 없습니다. MSAAppId와 TitleId가 게임과 연결된 값과 일치하지 않습니다.                    | [MicrosoftGame.config 요소 참조](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc) | 로그인/기본 사용자/타이틀 ID 구성을 확인한 후 사용자 흐름을 다시 시도하세요. |
| E\_GAMEUSER\_NO\_PACKAGE\_IDENTITY                | 0x89245110 | 패키지 ID를 구성해야 합니다.                                                              | [파트너 센터 초기 구성](/publishing/xstore-commerce/xstore-initial-configuration#1-reserving-a-name)             | 로그인/기본 사용자/타이틀 ID 구성을 확인한 후 사용자 흐름을 다시 시도하세요. |
| E\_GAMEUSER\_FAILED\_TO\_GET\_TOKEN               | 0x89245111 | 토큰 요청에 실패했습니다.                                                                 |                                                                                                         | 로그인/기본 사용자/타이틀 ID 구성을 확인한 후 사용자 흐름을 다시 시도하세요. |
| E\_GAMEUSER\_INVALID\_APP\_CONFIGURATION          | 0x89245112 | 게임 구성의 MSAAppId가 잘못되었거나 인증 스택에 대해 구성되지 않았습니다.                                  | [MicrosoftGame.config 요소 참조](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc) | 로그인/기본 사용자/타이틀 ID 구성을 확인한 후 사용자 흐름을 다시 시도하세요. |
| E\_GAMEUSER\_MALFORMED\_MSAAPPID                  | 0x89245113 | 게임 구성의 MSAAppId가 예상 형식(16자 문자열 또는 GUID)과 일치하지 않습니다.                            |                                                                                                         | 로그인/기본 사용자/타이틀 ID 구성을 확인한 후 사용자 흐름을 다시 시도하세요. |
| E\_GAMEUSER\_INCONSISTENT\_MSAAPPID\_AND\_TITLEID | 0x89245114 | 게임 구성의 MSAAppId와 TitleId가 게임과 연결된 값과 일치하지 않습니다.                                | [MicrosoftGame.config 요소 참조](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc) | 로그인/기본 사용자/타이틀 ID 구성을 확인한 후 사용자 흐름을 다시 시도하세요. |

## 게임 패키지

| 코드                                                                 | 값          | 설명                                                                                                                                                                                   | 출처                                                                                                      | 문제 해결                                               |
| ------------------------------------------------------------------ | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| E\_GAMEPACKAGE\_APP\_NOT\_PACKAGED                                 | 0x89245200 | 게임이 컨테이너로 패키지되어 있지 않습니다.                                                                                                                                                             |                                                                                                         | 패키지 설치/콘텐츠 상태를 확인하고 필요한 자산을 다시 배포한 후 재시도하세요.        |
| E\_GAMEPACKAGE\_NO\_INSTALLED\_LANGUAGES                           | 0x89245201 | 이 게임은 Intelligent Delivery를 사용하여 언어를 선택적으로 설치하지만 설치된 언어가 없습니다.                                                                                                                       | [Intelligent Delivery 언어](/build/core-features/common/packaging/intelligentdelivery-language)           | 패키지 설치/콘텐츠 상태를 확인하고 필요한 자산을 다시 배포한 후 재시도하세요.        |
| E\_GAMEPACKAGE\_NO\_STORE\_ID                                      | 0x89245202 | 애플리케이션의 게임 구성에 StoreId 특성을 설정해야 합니다.                                                                                                                                                 | [MicrosoftGame.config 요소 참조](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc) | 패키지 설치/콘텐츠 상태를 확인하고 필요한 자산을 다시 배포한 후 재시도하세요.        |
| E\_GAMEPACKAGE\_INVALID\_SELECTOR                                  | 0x89245203 | 패키지의 청크로 확인되지 않는 청크 선택자가 제공되었습니다.                                                                                                                                                    | [Chunk 요소 참조](/build/core-features/common/packaging/deployment/deployment-element-chunk)                | 패키지 설치/콘텐츠 상태를 확인하고 필요한 자산을 다시 배포한 후 재시도하세요.        |
| E\_GAMEPACKAGE\_DOWNLOAD\_REQUIRED                                 | 0x89245204 | 이 기기에서 패키지를 마운트하려면 하나 이상의 필수 청크를 다운로드해야 합니다.                                                                                                                                         |                                                                                                         | 패키지 설치/콘텐츠 상태를 확인하고 필요한 자산을 다시 배포한 후 재시도하세요.        |
| E\_GAMEPACKAGE\_NO\_TAG\_CHANGE                                    | 0x89245205 | 이 패키지에 설치된 청크는 태그가 아니라 Features를 사용하여 변경하세요.                                                                                                                                         | [Intelligent Delivery 레시피](/build/core-features/common/packaging/intelligentdelivery-features-recipes)  | 패키지 설치/콘텐츠 상태를 확인하고 필요한 자산을 다시 배포한 후 재시도하세요.        |
| E\_GAMEPACKAGE\_DLC\_NOT\_SUPPORTED                                | 0x89245206 | 게임이 해당 DLC 패키지를 지원하지 않습니다. 게임 구성에서 올바른 DLC 호환성을 확인하세요.                                                                                                                               | [MicrosoftGame.config 요소 참조](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc) | 패키지 설치/콘텐츠 상태를 확인하고 필요한 자산을 다시 배포한 후 재시도하세요.        |
| E\_GAMEPACKAGE\_DUPLICATE\_ID\_VALUES                              | 0x89245207 | 패키지에 동일한 'ID' 특성에 매핑되는 실행 파일이 두 개 이상 포함되어 있습니다. 'Executable' 요소에서 중복된 'ID' 특성이 있는지 확인하세요.                                                                                            | [MicrosoftGame.config 요소 참조](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc) | 패키지 설치/콘텐츠 상태를 확인하고 필요한 자산을 다시 배포한 후 재시도하세요.        |
| E\_GAMEPACKAGE\_NO\_PACKAGE\_IDENTIFIER                            | 0x89245208 | 패키지의 식별자를 확인할 수 없습니다. 패키지가 설치되지 않았을 수 있습니다.                                                                                                                                          |                                                                                                         | 패키지 설치/콘텐츠 상태를 확인하고 필요한 자산을 다시 배포한 후 재시도하세요.        |
| E\_GAMEPACKAGE\_CONFIG\_NO\_ROOT\_NODE                             | 0x89245209 | MicrosoftGame.config 파일에서 루트 `Game` 노드를 찾을 수 없습니다. 파일 형식이 올바른지 확인하세요.                                                                                                                | [MicrosoftGame.config 요소 참조](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc) | MicrosoftGame.config 스키마/값을 수정한 후 패키지를 다시 빌드/배포하세요. |
| E\_GAMEPACKAGE\_CONFIG\_ZERO\_VERSION                              | 0x8924520A | MicrosoftGame.config의 'Identity' 노드에 있는 'Version' 특성은 0.0.0.0이 될 수 없습니다. 이 특성을 증가시키거나 제거하세요. 버전을 지정하지 않으면 기본값은 1.0.0.0입니다.                                                           |                                                                                                         | MicrosoftGame.config 스키마/값을 수정한 후 패키지를 다시 빌드/배포하세요. |
| E\_GAMEPACKAGE\_CONFIG\_NO\_MSAAPPID\_NOTITLEID                    | 0x8924520B | MicrosoftGame.config에서 'MSAAppId' 또는 'TitleId' 요소가 누락되었습니다. configVersion >= 1을 사용할 때는 두 요소를 모두 지정해야 합니다.                                                                            | [MicrosoftGame.config 요소 참조](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc) | MicrosoftGame.config 스키마/값을 수정한 후 패키지를 다시 빌드/배포하세요. |
| E\_GAMEPACKAGE\_CONFIG\_DEPRECATED\_PC\_ENTRIES                    | 0x8924520C | configVersion >= 1에서는 DesktopRegistration 항목 "modFolder", "enableWritesToPackageRoot", "disableRegistryWriteVirtualization", "disableFilesystemWriteVirtualization"이 더 이상 사용되지 않습니다. |                                                                                                         | MicrosoftGame.config 스키마/값을 수정한 후 패키지를 다시 빌드/배포하세요. |
| E\_GAMEPACKAGE\_CONFIG\_SUM\_REQUIRES\_MSAAPPID                    | 0x8924520D | 간소화된 사용자 모델(AdvancedUserModel 요소) 및 configVersion >= 1을 사용할 때 'MSAAppId' 및 'TitleId' 요소는 필수입니다.                                                                                      | [MicrosoftGame.config 요소 참조](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc) | MicrosoftGame.config 스키마/값을 수정한 후 패키지를 다시 빌드/배포하세요. |
| E\_GAMEPACKAGE\_CONFIG\_NO\_CODE\_CLOUD\_SAVES\_REQUIRES\_MSAAPPID | 0x8924520E | 코드 없는 클라우드 저장(NoCodePCRoot 요소) 및 configVersion >= 1을 사용할 때 'MSAAppId' 및 'TitleId' 요소는 필수입니다.                                                                                         | [MicrosoftGame.config 요소 참조](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc) | MicrosoftGame.config 스키마/값을 수정한 후 패키지를 다시 빌드/배포하세요. |
| E\_GAMEPACKAGE\_CONFIG\_MSAAPPID\_OR\_TITLEID\_IS\_DEFAULT         | 0x8924520F | 'MSAAppId' 또는 'TitleId' 요소가 기본값입니다. NoCodePCRoot 또는 AdvancedUserModel이 지정되어 있고 configVersion >= 1을 사용하는 경우, TitleId와 MSAAppId 모두 파트너 센터에서 발급된 유효한 ID여야 합니다.                          | [MicrosoftGame.config 요소 참조](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc) | MicrosoftGame.config 스키마/값을 수정한 후 패키지를 다시 빌드/배포하세요. |

## 게임 스토어

| 코드                                                          | 값          | 설명                                                                               | 출처                                                       | 문제 해결                                      |
| ----------------------------------------------------------- | ---------- | -------------------------------------------------------------------------------- | -------------------------------------------------------- | ------------------------------------------ |
| E\_GAMESTORE\_LICENSE\_ACTION\_NOT\_APPLICABLE\_TO\_PRODUCT | 0x89245300 | 게임이 라이선스를 부여할 수 없는 제품에 대한 라이선스를 요청했습니다.                                          | [XStore 개요](/publishing/xstore-commerce/xstore-overview) | 스토어 연결, 사용 권한/라이선스 상태를 확인한 후 요청을 다시 시도하세요. |
| E\_GAMESTORE\_NETWORK\_ERROR                                | 0x89245301 | 게임이 스토어 네트워크와 통신하지 못했습니다.                                                        | [XStore 개요](/publishing/xstore-commerce/xstore-overview) | 스토어 연결, 사용 권한/라이선스 상태를 확인한 후 요청을 다시 시도하세요. |
| E\_GAMESTORE\_SERVER\_ERROR                                 | 0x89245302 | 게임이 스토어 서버로부터 잘못된 응답을 받았습니다.                                                     | [XStore 개요](/publishing/xstore-commerce/xstore-overview) | 스토어 연결, 사용 권한/라이선스 상태를 확인한 후 요청을 다시 시도하세요. |
| E\_GAMESTORE\_INSUFFICIENT\_QUANTITY                        | 0x89245303 | 사용자가 요청한 수량만큼의 소모품을 보유하고 있지 않습니다.                                                | [XStore 개요](/publishing/xstore-commerce/xstore-overview) | 스토어 연결, 사용 권한/라이선스 상태를 확인한 후 요청을 다시 시도하세요. |
| E\_GAMESTORE\_ALREADY\_PURCHASED                            | 0x89245304 | 사용자가 이미 이 제품을 소유하고 있습니다.                                                         | [XStore 개요](/publishing/xstore-commerce/xstore-overview) | 스토어 연결, 사용 권한/라이선스 상태를 확인한 후 요청을 다시 시도하세요. |
| E\_GAMESTORE\_LICENSE\_ACTION\_THROTTLED                    | 0x89245305 | 게임이 제품에 대한 라이선스를 과도하게 조회하여 현재 제한되어 있습니다. 동일 제품에 대해 10분 동안 30회의 라이선스 시도 제한이 있습니다. | [XStore 개요](/publishing/xstore-commerce/xstore-overview) | 스토어 연결, 사용 권한/라이선스 상태를 확인한 후 요청을 다시 시도하세요. |

## 게임 스트리밍

| 코드                                           | 값          | 설명                                                                                | 출처                                                                                              | 문제 해결                                            |
| -------------------------------------------- | ---------- | --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------ |
| E\_GAMESTREAMING\_NOT\_INITIALIZED           | 0x89245400 | XGameStreaming 런타임이 초기화되지 않았습니다. 다른 API를 호출하기 전에 XGameStreamingInitialize를 호출하세요. | [XGameStreamingInitialize](/reference/system/xgamestreaming/functions/xgamestreaminginitialize) | 스트리밍이 초기화되었고 클라이언트/세션 컨텍스트가 유효한지 확인한 후 다시 시도하세요. |
| E\_GAMESTREAMING\_CLIENT\_NOT\_CONNECTED     | 0x89245401 | 지정된 클라이언트가 연결되어 있지 않습니다.                                                          |                                                                                                 | 스트리밍이 초기화되었고 클라이언트/세션 컨텍스트가 유효한지 확인한 후 다시 시도하세요. |
| E\_GAMESTREAMING\_NO\_DATA                   | 0x89245402 | 요청한 데이터를 사용할 수 없습니다. 나중에 사용 가능해질 수 있습니다.                                          |                                                                                                 | 스트리밍이 초기화되었고 클라이언트/세션 컨텍스트가 유효한지 확인한 후 다시 시도하세요. |
| E\_GAMESTREAMING\_NO\_DATACENTER             | 0x89245403 | 현재 컴퓨터가 데이터 센터에서 실행되고 있지 않습니다.                                                    |                                                                                                 | 스트리밍이 초기화되었고 클라이언트/세션 컨텍스트가 유효한지 확인한 후 다시 시도하세요. |
| E\_GAMESTREAMING\_NOT\_STREAMING\_CONTROLLER | 0x89245404 | 현재 읽기가 스트리밍 컨트롤러에서 온 것이 아닙니다.                                                     |                                                                                                 | 스트리밍이 초기화되었고 클라이언트/세션 컨텍스트가 유효한지 확인한 후 다시 시도하세요. |

## 게임 저장

| 코드                                        | 값          | 설명                                                                              | 출처                                                         | 문제 해결                                                                                         |
| ----------------------------------------- | ---------- | ------------------------------------------------------------------------------- | ---------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| E\_GS\_INVALID\_CONTAINER\_NAME           | 0x80830001 | 컨테이너 이름이 잘못되었습니다. 유효한 컨테이너 이름 문자에는 대소문자, 숫자, 밑줄, 슬래시가 포함됩니다.                    | [XGameSave](/reference/system/xgamesave/xgamesave_members) | 자세한 문제 해결 지침은 [게임 저장 디버깅](/build/core-features/common/game-save/game-saves-debugging)을 참조하세요. |
| E\_GS\_NO\_ACCESS                         | 0x80830002 | 타이틀이 컨테이너 저장소에 접근할 권한이 없어 작업에 실패했습니다. SCID와 TitleId가 올바르게 구성되었는지 확인하세요.         | [XGameSave](/reference/system/xgamesave/xgamesave_members) | 자세한 문제 해결 지침은 [게임 저장 디버깅](/build/core-features/common/game-save/game-saves-debugging)을 참조하세요. |
| E\_GS\_OUT\_OF\_LOCAL\_STORAGE            | 0x80830003 | 게임을 저장하기에 기기의 저장 공간이 부족합니다.                                                     | [XGameSave](/reference/system/xgamesave/xgamesave_members) | 자세한 문제 해결 지침은 [게임 저장 디버깅](/build/core-features/common/game-save/game-saves-debugging)을 참조하세요. |
| E\_GS\_USER\_CANCELED                     | 0x80830004 | 사용자가 저장된 게임 다운로드를 취소했습니다.                                                       | [XGameSave](/reference/system/xgamesave/xgamesave_members) | 자세한 문제 해결 지침은 [게임 저장 디버깅](/build/core-features/common/game-save/game-saves-debugging)을 참조하세요. |
| E\_GS\_UPDATE\_TOO\_BIG                   | 0x80830005 | 저장 업데이트의 크기가 너무 큽니다. XGameSave 업데이트의 총 크기는 GS\_MAX\_BLOB\_SIZE(16MB)보다 작아야 합니다. | [XGameSave](/reference/system/xgamesave/xgamesave_members) | 자세한 문제 해결 지침은 [게임 저장 디버깅](/build/core-features/common/game-save/game-saves-debugging)을 참조하세요. |
| E\_GS\_QUOTA\_EXCEEDED                    | 0x80830006 | 이 사용자에 대한 타이틀의 저장소 할당량이 초과되었습니다.                                                | [XGameSave](/reference/system/xgamesave/xgamesave_members) | 자세한 문제 해결 지침은 [게임 저장 디버깅](/build/core-features/common/game-save/game-saves-debugging)을 참조하세요. |
| E\_GS\_PROVIDED\_BUFFER\_TOO\_SMALL       | 0x80830007 | API에 제공된 버퍼가 너무 작습니다.                                                           | [XGameSave](/reference/system/xgamesave/xgamesave_members) | 자세한 문제 해결 지침은 [게임 저장 디버깅](/build/core-features/common/game-save/game-saves-debugging)을 참조하세요. |
| E\_GS\_BLOB\_NOT\_FOUND                   | 0x80830008 | 지정된 blob을 찾을 수 없습니다.                                                            | [XGameSave](/reference/system/xgamesave/xgamesave_members) | 자세한 문제 해결 지침은 [게임 저장 디버깅](/build/core-features/common/game-save/game-saves-debugging)을 참조하세요. |
| E\_GS\_NO\_SERVICE\_CONFIGURATION         | 0x80830009 | 타이틀이 연결된 저장소용으로 올바르게 구성되지 않았습니다. SCID가 올바른지, 그리고 타이틀이 파트너 센터에 구성되어 있는지 확인하세요.   | [XGameSave](/reference/system/xgamesave/xgamesave_members) | 자세한 문제 해결 지침은 [게임 저장 디버깅](/build/core-features/common/game-save/game-saves-debugging)을 참조하세요. |
| E\_GS\_CONTAINER\_NOT\_IN\_SYNC           | 0x8083000A | 컨테이너가 아직 동기화되지 않았습니다. 업데이트를 제출하기 전에 XGameSave 컨테이너가 동기화되었는지 확인하세요.              | [XGameSave](/reference/system/xgamesave/xgamesave_members) | 자세한 문제 해결 지침은 [게임 저장 디버깅](/build/core-features/common/game-save/game-saves-debugging)을 참조하세요. |
| E\_GS\_CONTAINER\_SYNC\_FAILED            | 0x8083000B | 컨테이너 동기화에 실패했습니다.                                                               | [XGameSave](/reference/system/xgamesave/xgamesave_members) | 자세한 문제 해결 지침은 [게임 저장 디버깅](/build/core-features/common/game-save/game-saves-debugging)을 참조하세요. |
| E\_GS\_USER\_NOT\_REGISTERED\_IN\_SERVICE | 0x8083000C | 사용자의 MSA가 아직 XBOX 서비스 계정이 아닙니다.                                                 | [XGameSave](/reference/system/xgamesave/xgamesave_members) | 자세한 문제 해결 지침은 [게임 저장 디버깅](/build/core-features/common/game-save/game-saves-debugging)을 참조하세요. |
| E\_GS\_HANDLE\_EXPIRED                    | 0x8083000D | 함수에서 사용한 핸들이 만료되어 다시 획득해야 합니다.                                                  | [XGameSave](/reference/system/xgamesave/xgamesave_members) | 자세한 문제 해결 지침은 [게임 저장 디버깅](/build/core-features/common/game-save/game-saves-debugging)을 참조하세요. |
| E\_GS\_ASYNC\_FUNCTION\_REQUIRED          | 0x8083000E | 이 동기 함수가 시간에 민감한 스레드에서 호출되어 교착 상태 위험이 있습니다. 대신 비동기 구현을 사용하세요.                   | [XGameSave](/reference/system/xgamesave/xgamesave_members) | 자세한 문제 해결 지침은 [게임 저장 디버깅](/build/core-features/common/game-save/game-saves-debugging)을 참조하세요. |
| E\_GS\_PROVIDER\_MISMATCH                 | 0x8083000F | 게임에서 XGameSave와 XGameSaveFiles 호출을 혼합하여 사용하고 있으며, 이는 지원되지 않습니다.                 | [XGameSave](/reference/system/xgamesave/xgamesave_members) | 자세한 문제 해결 지침은 [게임 저장 디버깅](/build/core-features/common/game-save/game-saves-debugging)을 참조하세요. |

## 전역

| 코드                         | 값          | 설명                                   | 출처                                                                            | 문제 해결                                            |
| -------------------------- | ---------- | ------------------------------------ | ----------------------------------------------------------------------------- | ------------------------------------------------ |
| S\_OK                      | 0x00000000 | 작업이 성공적으로 완료되었습니다.                   | [XBOX Live HRESULT 오류 코드(전역)](/reference/live/xbl-hresult-error-codes#global) | 조치가 필요하지 않습니다.                                   |
| E\_PENDING                 | 0x8000000A | 작업이 시작되었지만 아직 완료되지 않았습니다.            | [XBOX Live HRESULT 오류 코드(전역)](/reference/live/xbl-hresult-error-codes#global) | 완료될 때까지 기다린 후 비동기 결과를 다시 조회하세요.                  |
| E\_BOUNDS                  | 0x8000000B | 제공된 인덱스 또는 범위가 유효한 경계를 벗어났습니다.       | [XBOX Live HRESULT 오류 코드(전역)](/reference/live/xbl-hresult-error-codes#global) | 다시 시도하기 전에 인덱스와 범위 경계를 확인하세요.                    |
| E\_NOTIMPL                 | 0x80004001 | 이 기능은 구현되지 않았습니다.                    | [XBOX Live HRESULT 오류 코드(전역)](/reference/live/xbl-hresult-error-codes#global) | 이 플랫폼 및 런타임에서 지원되는 API 경로를 사용하세요.                |
| E\_NOINTERFACE             | 0x80004002 | 요청한 인터페이스를 이 객체에서 사용할 수 없습니다.        | [XBOX Live HRESULT 오류 코드(전역)](/reference/live/xbl-hresult-error-codes#global) | 이 인터페이스를 쿼리하기 전에 인터페이스 가용성/버전을 확인하세요.            |
| E\_POINTER                 | 0x80004003 | 필수 포인터가 null이거나 잘못되었습니다.             | [XBOX Live HRESULT 오류 코드(전역)](/reference/live/xbl-hresult-error-codes#global) | 호출하기 전에 모든 포인터/핸들과 객체 수명을 확인하세요.                 |
| E\_ABORT                   | 0x80004004 | 작업이 완료되기 전에 중단되었습니다.                 | [XBOX Live HRESULT 오류 코드(전역)](/reference/live/xbl-hresult-error-codes#global) | 취소/종료 상태를 확인하고 안정된 후에 다시 실행하세요.                  |
| E\_FAIL                    | 0x80004005 | 지정되지 않은 오류로 작업이 실패했습니다.              | [XBOX Live HRESULT 오류 코드(전역)](/reference/live/xbl-hresult-error-codes#global) | 선행 오류에 대해 로그를 검토하고 입력/상태를 수정한 후 다시 시도하세요.        |
| E\_UNEXPECTED              | 0x8000FFFF | 예기치 않은 내부 오류가 발생했습니다.                | [XBOX Live HRESULT 오류 코드(전역)](/reference/live/xbl-hresult-error-codes#global) | 진단 정보를 수집하고 시나리오를 다시 시작한 후, 재현되면 에스컬레이션하세요.      |
| E\_ACCESSDENIED            | 0x80070005 | 요청한 리소스 또는 작업에 대한 접근이 거부되었습니다.       | [XBOX Live HRESULT 오류 코드(전역)](/reference/live/xbl-hresult-error-codes#global) | 권한, 기능, 사용자/계정 컨텍스트를 확인한 후 다시 시도하세요.             |
| E\_OUTOFMEMORY             | 0x8007000E | 메모리 할당을 충족할 수 없어 작업에 실패했습니다.         | [XBOX Live HRESULT 오류 코드(전역)](/reference/live/xbl-hresult-error-codes#global) | 메모리 사용량을 줄이고 할당을 해제한 후 다시 시도하세요.                 |
| E\_NOT\_SUPPORTED          | 0x80070032 | 현재 컨텍스트에서는 이 작업이 지원되지 않습니다.          | [XBOX Live HRESULT 오류 코드(전역)](/reference/live/xbl-hresult-error-codes#global) | 현재 컨텍스트에서 지원되는 작업을 사용하세요.                        |
| E\_INVALIDARG              | 0x80070057 | 하나 이상의 인수가 잘못되었습니다.                  | [XBOX Live HRESULT 오류 코드(전역)](/reference/live/xbl-hresult-error-codes#global) | 인수 값과 필수 조합을 확인한 후 다시 시도하세요.                     |
| E\_NOT\_SUFFICIENT\_BUFFER | 0x8007007A | 요청한 데이터에 비해 제공된 버퍼가 너무 작습니다.         | [XBOX Live HRESULT 오류 코드(전역)](/reference/live/xbl-hresult-error-codes#global) | 필요한 크기를 쿼리하고 버퍼 크기를 조정한 후 다시 시도하세요.              |
| E\_TIME\_CRITICAL\_THREAD  | 0x800701A0 | 시간에 민감한 스레드에서는 이 호출이 허용되지 않습니다.      | [XBOX Live HRESULT 오류 코드(전역)](/reference/live/xbl-hresult-error-codes#global) | 이 호출을 시간에 민감한 스레드 밖으로 옮기고, 가능한 경우 비동기 패턴을 사용하세요. |
| E\_NO\_TASK\_QUEUE         | 0x800701AB | 작업에 사용할 태스크 큐가 제공되지 않았거나 사용할 수 없습니다. | [XBOX Live HRESULT 오류 코드(전역)](/reference/live/xbl-hresult-error-codes#global) | 이 작업을 호출하기 전에 유효한 태스크 큐를 제공하세요.                  |

## HTTP 클라이언트

| 코드                                         | 값          | 설명                                      | 출처                                                                                         | 문제 해결                                                             |
| ------------------------------------------ | ---------- | --------------------------------------- | ------------------------------------------------------------------------------------------ | ----------------------------------------------------------------- |
| HTTP\_E\_STATUS\_UNEXPECTED                | 0x80190001 | HTTP 클라이언트가 예기치 않은 프로토콜/상태 조건을 발견했습니다.  | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| HTTP\_E\_STATUS\_UNEXPECTED\_SERVER\_ERROR | 0x80190005 | 서버가 예기치 않은 오류 조건을 반환했습니다.               | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| HTTP\_E\_STATUS\_AMBIGUOUS                 | 0x8019012C | HTTP 응답이 모호한 리소스 일치를 나타냅니다.             | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| HTTP\_E\_STATUS\_MOVED                     | 0x8019012D | HTTP 리디렉션이 리소스가 이동되었음을 나타냅니다.           | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| HTTP\_E\_STATUS\_REDIRECT                  | 0x8019012E | HTTP 리디렉션 응답을 수신했습니다.                   | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| HTTP\_E\_STATUS\_REDIRECT\_METHOD          | 0x8019012F | 메서드 변경이 필요한 HTTP 리디렉션입니다.               | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| HTTP\_E\_STATUS\_NOT\_MODIFIED             | 0x80190130 | HTTP 304: 조건부 요청 이후로 리소스가 변경되지 않았습니다.   | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| HTTP\_E\_STATUS\_USE\_PROXY                | 0x80190131 | HTTP 요청은 프록시를 통해 이루어져야 합니다.             | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| HTTP\_E\_STATUS\_REDIRECT\_KEEP\_VERB      | 0x80190133 | 원래 메서드/동사를 유지하는 HTTP 리디렉션입니다.           | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| HTTP\_E\_STATUS\_BAD\_REQUEST              | 0x80190190 | HTTP 400: 요청 형식이 잘못되었거나 유효하지 않습니다.      | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| HTTP\_E\_STATUS\_DENIED                    | 0x80190191 | HTTP 401: 요청이 인증되지 않았거나 거부되었습니다.        | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| HTTP\_E\_STATUS\_PAYMENT\_REQ              | 0x80190192 | HTTP 402: 이 요청에는 결제가 필요합니다.             | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| HTTP\_E\_STATUS\_FORBIDDEN                 | 0x80190193 | HTTP 403: 이 리소스에 대한 접근이 금지되었습니다.        | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| HTTP\_E\_STATUS\_NOT\_FOUND                | 0x80190194 | HTTP 404: 요청한 리소스를 찾을 수 없습니다.           | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| HTTP\_E\_STATUS\_BAD\_METHOD               | 0x80190195 | 이 엔드포인트에 대해 HTTP 메서드가 유효하지 않습니다.        | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| HTTP\_E\_STATUS\_NONE\_ACCEPTABLE          | 0x80190196 | HTTP 406: 사용할 수 있는 표현이 없습니다.            | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| HTTP\_E\_STATUS\_PROXY\_AUTH\_REQ          | 0x80190197 | HTTP 407: 프록시 인증이 필요합니다.                | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| HTTP\_E\_STATUS\_REQUEST\_TIMEOUT          | 0x80190198 | HTTP 408: 서버가 요청을 기다리다가 시간 초과되었습니다.     | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| HTTP\_E\_STATUS\_CONFLICT                  | 0x80190199 | HTTP 409: 요청이 현재 서버 상태와 충돌합니다.          | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| HTTP\_E\_STATUS\_GONE                      | 0x8019019A | HTTP 410: 요청한 리소스가 더 이상 제공되지 않습니다.      | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| HTTP\_E\_STATUS\_LENGTH\_REQUIRED          | 0x8019019B | HTTP 411: Content-Length가 필요합니다.        | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| HTTP\_E\_STATUS\_PRECOND\_FAILED           | 0x8019019C | HTTP 412: 요청 전제 조건이 실패했습니다.             | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| HTTP\_E\_STATUS\_REQUEST\_TOO\_LARGE       | 0x8019019D | HTTP 413: 요청 페이로드가 너무 큽니다.              | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| HTTP\_E\_STATUS\_URI\_TOO\_LONG            | 0x8019019E | HTTP 414: 요청 URI가 너무 깁니다.               | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| HTTP\_E\_STATUS\_UNSUPPORTED\_MEDIA        | 0x8019019F | HTTP 415: 미디어 유형이 지원되지 않습니다.            | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| HTTP\_E\_STATUS\_RANGE\_NOT\_SATISFIABLE   | 0x801901A0 | HTTP 416: 요청한 범위를 충족할 수 없습니다.           | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| HTTP\_E\_STATUS\_EXPECTATION\_FAILED       | 0x801901A1 | HTTP 417: 서버가 요청 기대치를 충족할 수 없습니다.       | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| FGRL (Rate Limit) Exceeded                 | 0x801901AD | 속도 제한이 초과되어 요청이 제한되었습니다.                | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | 요청 속도를 낮추고 지수 백오프와 함께 쿨다운 후 다시 시도하세요.                             |
| HTTP\_E\_STATUS\_SERVER\_ERROR             | 0x801901F4 | HTTP 500: 서버에 내부 오류가 발생했습니다.            | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| HTTP\_E\_STATUS\_NOT\_SUPPORTED            | 0x801901F5 | 요청한 HTTP 기능이 지원되지 않습니다.                 | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| HTTP\_E\_STATUS\_BAD\_GATEWAY              | 0x801901F6 | HTTP 502: 업스트림 서버로부터 잘못된 응답을 받았습니다.     | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| HTTP\_E\_STATUS\_SERVICE\_UNAVAIL          | 0x801901F7 | HTTP 503: 서비스를 일시적으로 사용할 수 없습니다.        | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| HTTP\_E\_STATUS\_GATEWAY\_TIMEOUT          | 0x801901F8 | HTTP 504: 업스트림 서버가 시간 초과되었습니다.          | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| HTTP\_E\_STATUS\_VERSION\_NOT\_SUP         | 0x801901F9 | 서버가 HTTP 버전을 지원하지 않습니다.                 | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | HTTP 상태/응답 본문을 검사하고 요청/인증/구성을 수정한 후, 일시적 실패의 경우 백오프와 함께 다시 시도하세요. |
| ONL\_E\_ACTION\_REQUIRED                   | 0x8086000C | 작업을 계속하기 전에 사용자 또는 타이틀의 조치가 필요합니다.      | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | 서비스가 지시하는 필수 사용자/타이틀 조치를 완료한 후 다시 시도하세요.                          |
| WEB\_E\_UNEXPECTED\_CONTENT                | 0x83750005 | 응답 콘텐츠가 예상 형식과 일치하지 않습니다.               | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | 응답 형식/콘텐츠 유형과 서비스 계약을 확인한 후 다시 시도하세요.                             |
| WEB\_E\_INVALID\_JSON\_STRING              | 0x83750007 | JSON 페이로드가 잘못되었거나 형식이 올바르지 않습니다.        | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | 전송 또는 구문 분석 전에 JSON 페이로드 스키마/인코딩을 확인하세요.                          |
| E\_HC\_NOT\_INITIALISED                    | 0x89235001 | HTTP 클라이언트 런타임이 초기화되지 않았습니다.            | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | 요청을 실행하기 전에 HTTP 클라이언트 런타임을 초기화하세요.                               |
| E\_HC\_PERFORM\_ALREADY\_CALLED            | 0x89235003 | 이 HTTP 작업이 이미 실행되었습니다.                  | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | 다른 perform 호출을 위해 새 요청 객체를 생성하세요.                                 |
| E\_HC\_ALREADY\_INITIALISED                | 0x89235004 | HTTP 클라이언트 런타임이 이미 초기화되어 있습니다.          | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | 중복 초기화를 피하고 프로세스 수명 주기당 한 번만 초기화하세요.                              |
| E\_HC\_CONNECT\_ALREADY\_CALLED            | 0x89235005 | 이 WebSocket/세션에 대해 이미 Connect가 호출되었습니다. | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | 재연결 대신 활성 연결/세션을 재사용하거나 새로 생성하세요.                                 |
| E\_HC\_NO\_NETWORK                         | 0x89235006 | 현재 사용 가능한 네트워크 연결이 없습니다.                | [XBOX Live HRESULT 오류 코드(HTTP 클라이언트)](/reference/live/xbl-hresult-error-codes#http-client) | 네트워크 연결을 복구한 후 다시 시도하세요.                                          |

## 인증 관리자(AM)

| 코드                                | 값          | 설명                                                             | 출처                                                                                                   | 문제 해결                                              |
| --------------------------------- | ---------- | -------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | -------------------------------------------------- |
| AM\_E\_XSTS\_UNEXPECTED           | 0x87DD0006 | NSAL 대상은 구성되어 있지만 신뢰 당사자 인증서가 아직 XBOX 서비스에서 신뢰되지 않습니다.         | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 샌드박스, NSAL 대상, TitleId/SCID 구성을 확인하고 토큰을 다시 획득하세요. |
| AM\_E\_NOT\_AUTHORIZED            | 0x87DD0009 | 사용자가 현재 TitleId 및 SandboxId 구성에 대해 XSTS 토큰을 요청할 권한이 없습니다.      | [샌드박스 설정 문제 해결](/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes)         | 샌드박스, NSAL 대상, TitleId/SCID 구성을 확인하고 토큰을 다시 획득하세요. |
| AM\_E\_UNKNOWN\_TARGET            | 0x87DD000B | 요청한 토큰 대상을 타이틀의 NSAL 구성에서 찾을 수 없습니다.                           | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 샌드박스, NSAL 대상, TitleId/SCID 구성을 확인하고 토큰을 다시 획득하세요. |
| AM\_E\_TITLE\_NOT\_AUTHENTICATED  | 0x87DD000D | 현재 서비스 구성에 대해 타이틀이 인증되지 않았습니다(예: TitleId, SCID 또는 샌드박스 설정 문제). | [샌드박스 설정 문제 해결](/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes)         | 샌드박스, NSAL 대상, TitleId/SCID 구성을 확인하고 토큰을 다시 획득하세요. |
| AM\_E\_USER\_NOT\_FOUND           | 0x87DD0013 | 사용자 객체가 더 이상 로그인되어 있지 않거나 알 수 없습니다.                            | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 샌드박스, NSAL 대상, TitleId/SCID 구성을 확인하고 토큰을 다시 획득하세요. |
| AM\_E\_XSTS\_TIMEOUT              | 0x87DD0019 | X-토큰을 검색하는 동안 시간 초과 제한에 도달했습니다.                                | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 샌드박스, NSAL 대상, TitleId/SCID 구성을 확인하고 토큰을 다시 획득하세요. |
| AM\_E\_NO\_TOKEN\_REQUIRED        | 0x87DD0021 | 해당 엔드포인트가 NSAL에 토큰 대상으로 구성되어 있지 않기 때문에 요청에 토큰이 필요하지 않습니다.      | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 샌드박스, NSAL 대상, TitleId/SCID 구성을 확인하고 토큰을 다시 획득하세요. |
| AM\_E\_XTITLE\_TIMEOUT            | 0x87DD0022 | 타이틀 토큰을 검색하는 동안 시간 초과 제한에 도달했습니다.                              | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 샌드박스, NSAL 대상, TitleId/SCID 구성을 확인하고 토큰을 다시 획득하세요. |
| AM\_E\_XSTS\_SERVICE\_UNAVAILABLE | 0x87DD0033 | X 토큰 서비스를 사용할 수 없습니다.                                          | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 샌드박스, NSAL 대상, TitleId/SCID 구성을 확인하고 토큰을 다시 획득하세요. |

## XUser 토큰 및 서명

| 코드                                         | 값          | 설명                                                                                                   | 출처                                                                                                   | 문제 해결                                   |
| ------------------------------------------ | ---------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | --------------------------------------- |
| WININET\_E\_NAME\_NOT\_RESOLVED            | 0x80072EE7 | 서버 이름 또는 주소를 확인할 수 없습니다.                                                                             | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 네트워크/DNS/프록시 연결을 확인한 후 토큰 획득을 다시 시도하세요. |
| WININET\_E\_CANNOT\_CONNECT                | 0x80072EFD | 서버와의 연결을 설정할 수 없습니다.                                                                                 | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 네트워크/DNS/프록시 연결을 확인한 후 토큰 획득을 다시 시도하세요. |
| WININET\_E\_CONNECTION\_ABORTED            | 0x80072EFE | 서버와의 연결이 비정상적으로 종료되었습니다.                                                                             | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 네트워크/DNS/프록시 연결을 확인한 후 토큰 획득을 다시 시도하세요. |
| WININET\_E\_DECODING\_FAILED               | 0x80072F8F | 콘텐츠 디코딩에 실패했습니다.                                                                                     | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 네트워크/DNS/프록시 연결을 확인한 후 토큰 획득을 다시 시도하세요. |
| XO\_E\_GAME\_USAGE\_BY\_USER\_EXCEEDED     | 0x8015DBFF | 사용자가 게임을 플레이할 수 있는 할당된 시간을 초과했습니다(자녀 보호).                                                            | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 계정/시스템 정책 제한을 해결한 후 토큰 획득을 다시 시도하세요.    |
| XO\_E\_SYSTEM\_UPDATE\_REQUIRED            | 0x8015DC01 | X-토큰을 발급하기 전에 시스템을 업데이트해야 합니다.                                                                       | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 계정/시스템 정책 제한을 해결한 후 토큰 획득을 다시 시도하세요.    |
| XO\_E\_ACCOUNT\_COUNTRY\_NOT\_AUTHORIZED   | 0x8015DC0B | 타이틀이 허용되지 않은 국가/지역에서 사용되고 있습니다.                                                                      | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 계정/시스템 정책 제한을 해결한 후 토큰 획득을 다시 시도하세요.    |
| XO\_E\_DEVICE\_COUNT\_FOR\_TITLE\_EXCEEDED | 0x8015DC1E | 이미 다른 기기에서 이 게임을 플레이하고 있습니다. 여기에서 플레이하려면 해당 게임을 닫으세요. Single Point of Presence(SPoP / XR-115) 정책 시행. | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 계정/시스템 정책 제한을 해결한 후 토큰 획득을 다시 시도하세요.    |
| ONL\_E\_FORCESIGNIN                        | 0x80860006 | 계정 보호를 위해 사용자가 다시 로그인해야 합니다.                                                                         | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 사용자에게 다시 로그인하도록 요청한 후 요청을 다시 시도하세요.     |

## XAL

| 코드                                  | 값          | 설명                                | 출처                                                                          | 문제 해결                                       |
| ----------------------------------- | ---------- | --------------------------------- | --------------------------------------------------------------------------- | ------------------------------------------- |
| E\_XAL\_NOTINITIALIZED              | 0x89235001 | XAL이 초기화되지 않았습니다.                 | [XBOX Live HRESULT 오류 코드(XAL)](/reference/live/xbl-hresult-error-codes#xal) | XAL 종속 API를 사용하기 전에 XAL을 초기화하세요.            |
| E\_XAL\_ALREADYINITIALIZED          | 0x89235101 | XAL이 이미 초기화되었습니다.                 | [XBOX Live HRESULT 오류 코드(XAL)](/reference/live/xbl-hresult-error-codes#xal) | 동일한 수명 주기 내에서 XAL 중복 초기화를 피하세요.             |
| E\_XAL\_USERSETNOTEMPTY             | 0x89235102 | 대상 사용자 집합이 비어 있지 않습니다.            | [XBOX Live HRESULT 오류 코드(XAL)](/reference/live/xbl-hresult-error-codes#xal) | XAL 사용자 집합/세션 상태를 확인하고 예상된 호출 순서로 다시 시도하세요. |
| E\_XAL\_USERSETFULL                 | 0x89235103 | 사용자 집합이 최대 용량에 도달했습니다.            | [XBOX Live HRESULT 오류 코드(XAL)](/reference/live/xbl-hresult-error-codes#xal) | XAL 사용자 집합/세션 상태를 확인하고 예상된 호출 순서로 다시 시도하세요. |
| E\_XAL\_USERSIGNEDOUT               | 0x89235104 | 대상 사용자가 로그아웃되었습니다.                | [XBOX Live HRESULT 오류 코드(XAL)](/reference/live/xbl-hresult-error-codes#xal) | XAL 사용자 집합/세션 상태를 확인하고 예상된 호출 순서로 다시 시도하세요. |
| E\_XAL\_DUPLICATEDUSER              | 0x89235105 | 사용자가 이미 사용자 집합에 존재합니다.            | [XBOX Live HRESULT 오류 코드(XAL)](/reference/live/xbl-hresult-error-codes#xal) | XAL 사용자 집합/세션 상태를 확인하고 예상된 호출 순서로 다시 시도하세요. |
| E\_XAL\_NETWORK                     | 0x89235106 | 요청을 처리하는 동안 네트워크 오류가 발생했습니다.      | [XBOX Live HRESULT 오류 코드(XAL)](/reference/live/xbl-hresult-error-codes#xal) | XAL 사용자 집합/세션 상태를 확인하고 예상된 호출 순서로 다시 시도하세요. |
| E\_XAL\_CLIENTERROR                 | 0x89235107 | XAL에서 클라이언트 측 오류가 발생했습니다.         | [XBOX Live HRESULT 오류 코드(XAL)](/reference/live/xbl-hresult-error-codes#xal) | XAL 사용자 집합/세션 상태를 확인하고 예상된 호출 순서로 다시 시도하세요. |
| E\_XAL\_UIREQUIRED                  | 0x89235108 | 작업을 완료하려면 사용자 상호작용이 필요합니다.        | [XBOX Live HRESULT 오류 코드(XAL)](/reference/live/xbl-hresult-error-codes#xal) | XAL 사용자 집합/세션 상태를 확인하고 예상된 호출 순서로 다시 시도하세요. |
| E\_XAL\_HANDLERALREADYREGISTERED    | 0x89235109 | 필요한 처리기가 이미 등록되어 있습니다.            | [XBOX Live HRESULT 오류 코드(XAL)](/reference/live/xbl-hresult-error-codes#xal) | XAL 사용자 집합/세션 상태를 확인하고 예상된 호출 순서로 다시 시도하세요. |
| E\_XAL\_UNEXPECTEDUSERSIGNEDIN      | 0x8923510A | 작업 중에 다른 또는 예기치 않은 사용자가 로그인했습니다.  | [XBOX Live HRESULT 오류 코드(XAL)](/reference/live/xbl-hresult-error-codes#xal) | XAL 사용자 집합/세션 상태를 확인하고 예상된 호출 순서로 다시 시도하세요. |
| E\_XAL\_NOTATTACHEDTOJVM            | 0x8923510B | 필요할 때 XAL이 Java VM에 연결되어 있지 않습니다. | [XBOX Live HRESULT 오류 코드(XAL)](/reference/live/xbl-hresult-error-codes#xal) | XAL 사용자 집합/세션 상태를 확인하고 예상된 호출 순서로 다시 시도하세요. |
| E\_XAL\_DEVICEUSER                  | 0x8923510C | 이 작업은 현재 기기 사용자 컨텍스트에서 유효하지 않습니다. | [XBOX Live HRESULT 오류 코드(XAL)](/reference/live/xbl-hresult-error-codes#xal) | XAL 사용자 집합/세션 상태를 확인하고 예상된 호출 순서로 다시 시도하세요. |
| E\_XAL\_DEFERRALNOTAVAILABLE        | 0x8923510D | 지금은 지연을 요청할 수 없습니다.               | [XBOX Live HRESULT 오류 코드(XAL)](/reference/live/xbl-hresult-error-codes#xal) | XAL 사용자 집합/세션 상태를 확인하고 예상된 호출 순서로 다시 시도하세요. |
| E\_XAL\_MISSINGPLATFORMEVENTHANDLER | 0x8923510E | 필요한 플랫폼 이벤트 처리기가 누락되었습니다.         | [XBOX Live HRESULT 오류 코드(XAL)](/reference/live/xbl-hresult-error-codes#xal) | XAL 사용자 집합/세션 상태를 확인하고 예상된 호출 순서로 다시 시도하세요. |
| E\_XAL\_USERNOTFOUND                | 0x8923510F | 지정된 사용자를 찾을 수 없습니다.               | [XBOX Live HRESULT 오류 코드(XAL)](/reference/live/xbl-hresult-error-codes#xal) | XAL 사용자 집합/세션 상태를 확인하고 예상된 호출 순서로 다시 시도하세요. |
| E\_XAL\_NOTOKENREQUIRED             | 0x89235110 | 이 요청에는 토큰이 필요하지 않습니다.             | [XBOX Live HRESULT 오류 코드(XAL)](/reference/live/xbl-hresult-error-codes#xal) | XAL 사용자 집합/세션 상태를 확인하고 예상된 호출 순서로 다시 시도하세요. |
| E\_XAL\_NODEFAULTUSER               | 0x89235111 | 현재 사용 가능한 기본 사용자가 없습니다.           | [XBOX Live HRESULT 오류 코드(XAL)](/reference/live/xbl-hresult-error-codes#xal) | XAL 사용자 집합/세션 상태를 확인하고 예상된 호출 순서로 다시 시도하세요. |
| E\_XAL\_FAILEDTORESOLVE             | 0x89235112 | XAL이 요청한 권한 또는 ID 상태를 확인할 수 없습니다. | [XBOX Live HRESULT 오류 코드(XAL)](/reference/live/xbl-hresult-error-codes#xal) | XAL 사용자 집합/세션 상태를 확인하고 예상된 호출 순서로 다시 시도하세요. |

## XSAPI

| 코드                                        | 값          | 설명                                                                                                      | 출처                                                                              | 문제 해결                                                                                                                |
| ----------------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| E\_XBL\_RUNTIME\_ERROR                    | 0x89235200 | 일반적인 XBOX Live 런타임 오류가 발생했습니다.                                                                          | [XBOX Live HRESULT 오류 코드(XSAPI)](/reference/live/xbl-hresult-error-codes#xsapi) | XSAPI 초기화, 인증 토큰 가용성, 서비스 상태를 확인한 후 다시 시도하세요.                                                                        |
| E\_XBL\_RTA\_GENERIC\_ERROR               | 0x89235201 | 일반적인 Real-Time Activity(RTA) 오류가 발생했습니다.                                                                | [XBOX Live HRESULT 오류 코드(XSAPI)](/reference/live/xbl-hresult-error-codes#xsapi) | XSAPI 초기화, 인증 토큰 가용성, 서비스 상태를 확인한 후 다시 시도하세요.                                                                        |
| E\_XBL\_RTA\_SUBSCRIPTION\_LIMIT\_REACHED | 0x89235202 | RTA 구독 한도에 도달했습니다.                                                                                      | [XBOX Live HRESULT 오류 코드(XSAPI)](/reference/live/xbl-hresult-error-codes#xsapi) | XSAPI 초기화, 인증 토큰 가용성, 서비스 상태를 확인한 후 다시 시도하세요.                                                                        |
| E\_XBL\_RTA\_ACCESS\_DENIED               | 0x89235203 | RTA 기능에 대한 접근이 거부되었습니다.                                                                                 | [XBOX Live HRESULT 오류 코드(XSAPI)](/reference/live/xbl-hresult-error-codes#xsapi) | XSAPI 초기화, 인증 토큰 가용성, 서비스 상태를 확인한 후 다시 시도하세요.                                                                        |
| E\_XBL\_AUTH\_UNKNOWN\_ERROR              | 0x89235204 | 알 수 없는 인증 오류가 발생했습니다.                                                                                   | [XBOX Live HRESULT 오류 코드(XSAPI)](/reference/live/xbl-hresult-error-codes#xsapi) | XSAPI 초기화, 인증 토큰 가용성, 서비스 상태를 확인한 후 다시 시도하세요.                                                                        |
| E\_XBL\_AUTH\_RUNTIME\_ERROR              | 0x89235205 | 런타임 오류로 인해 인증에 실패했습니다.                                                                                  | [XBOX Live HRESULT 오류 코드(XSAPI)](/reference/live/xbl-hresult-error-codes#xsapi) | XSAPI 초기화, 인증 토큰 가용성, 서비스 상태를 확인한 후 다시 시도하세요.                                                                        |
| E\_XBL\_AUTH\_NO\_TOKEN                   | 0x89235206 | 사용 가능한 인증 토큰이 없습니다.                                                                                     | [XBOX Live HRESULT 오류 코드(XSAPI)](/reference/live/xbl-hresult-error-codes#xsapi) | XSAPI 초기화, 인증 토큰 가용성, 서비스 상태를 확인한 후 다시 시도하세요.                                                                        |
| E\_XBL\_ALREADY\_INITIALIZED              | 0x89235207 | XBOX Live 서비스가 이미 초기화되었습니다.                                                                             | [XBOX Live HRESULT 오류 코드(XSAPI)](/reference/live/xbl-hresult-error-codes#xsapi) | XBOX 서비스 중복 초기화 호출을 피하세요.                                                                                            |
| E\_XBL\_NOT\_INITIALIZED                  | 0x89235208 | XBOX Live 서비스가 초기화되지 않았습니다.                                                                             | [XBOX Live HRESULT 오류 코드(XSAPI)](/reference/live/xbl-hresult-error-codes#xsapi) | XBOX 서비스 API를 호출하기 전에 XblInitialize를 호출하세요.                                                                          |
| E\_XBL\_RTA\_NOT\_ACTIVATED               | 0x89235209 | Real-Time Activity 서비스가 활성화되지 않았습니다. Real-Time Activity 서비스를 활성화하려면 XblRealTimeActivityActivate를 호출하세요. | [오류 조회(xberror.exe)](/tools/tools-console/commandlinetools/xberror)             | Real-Time Activity 서비스가 활성화되지 않았습니다. Real-Time Activity 서비스를 활성화하려면 XblRealTimeActivityActivate를 호출하세요. (0x89235209) |

## 콘솔 도구 및 전송

| 코드                                                           | 값          | 설명                                 | 출처                                                                      | 문제 해결                                                                                     |
| ------------------------------------------------------------ | ---------- | ---------------------------------- | ----------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| E\_APP\_USER\_TERMINATE\_REQUEST                             | 0x87E1001D | 사용자가 명시적으로 앱 종료를 요청했습니다.           | [오류 조회(xberror.exe)](/tools/tools-console/commandlinetools/xberror)     | 사용자가 명시적으로 앱 종료를 요청했습니다. (0x87E1001D)                                                     |
| E\_DSTORAGE\_XVD\_DEVICE\_NOT\_SUPPORTED                     | 0x89240004 | 지정된 XVD가 지원되는 NVMe 장치에 없습니다.       | [오류 조회(xberror.exe)](/tools/tools-console/commandlinetools/xberror)     | 지정된 XVD가 지원되는 NVMe 장치에 없습니다.                                                              |
| E\_COULD\_NOT\_CONNECT                                       | 0x8C110303 | 지정된 devkit에 연결하지 못했습니다.            | [XTF 전송 오류](/tools/tools-console/commandlinetools/xtf-transport-errors) | 대상 콘솔에 연결할 수 없습니다. 지정된 HostName 또는 IP 주소를 확인하세요. 방화벽, 네트워크 설정 및 콘솔에 대한 ping 가능 여부를 확인하세요. |
| E\_XTFAPP\_APPLICATION\_EXITED\_BEFORE\_ACTIVATION\_COMPLETE | 0x8D160122 | 활성화가 완료되기 전에 애플리케이션이 종료되거나 충돌했습니다. | [XTF 전송 오류](/tools/tools-console/commandlinetools/xtf-transport-errors) | 없음.                                                                                       |
| E\_XTFAPP\_DIRECTORY\_NOT\_FOUND                             | 0x8D16018D | 제공된 디렉터리를 찾을 수 없습니다.               | [XTF 전송 오류](/tools/tools-console/commandlinetools/xtf-transport-errors) | 디렉터리가 존재하는지 확인하세요.                                                                        |

## XBOX PC Remote Iteration

| 코드                        | 값          | 설명                                                                   | 출처                                                                    | 문제 해결                                                                                                    |
| ------------------------- | ---------- | -------------------------------------------------------------------- | --------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| E\_PROCESSNOTFOUND        | 0x8C114002 | 프로세스를 찾을 수 없습니다. 프로세스 ID가 활성 대상 프로세스와 일치하는지 확인하세요.                   | [XBOX PC Remote Iteration API 오류 코드](/reference/remoting/error-codes) | 실행 중인 프로세스 목록을 확인하여 대상 프로세스의 프로세스 ID를 검증하고, 활성 프로세스의 유효한 프로세스 ID를 제공하세요.                                 |
| E\_INVALIDPROCESSID       | 0x8C114003 | 잘못된 프로세스 ID입니다. 숫자 형식의 프로세스 ID를 제공하세요.                               | [XBOX PC Remote Iteration API 오류 코드](/reference/remoting/error-codes) | 숫자만 포함된 유효한 프로세스 ID를 제공하세요.                                                                              |
| E\_INVALIDPIN             | 0x8C114004 | PIN이 예상된 형식이 아닙니다. 유효한 6자 PIN을 입력하세요.                                | [XBOX PC Remote Iteration API 오류 코드](/reference/remoting/error-codes) | 클라이언트 장치에서 올바른 PIN을 입력하세요.                                                                               |
| E\_INVALIDSSHKEY          | 0x8C114005 | SSH 키가 예상된 형식이 아닙니다. 유효한 공개 키를 사용하고 페어링을 다시 시도하세요.                   | [XBOX PC Remote Iteration API 오류 코드](/reference/remoting/error-codes) | 유효한 SSH 공개 키를 생성하고, 유효한 키의 경로를 제공하여 페어링을 다시 실행하세요.                                                       |
| E\_PAIRINGTIMEOUT         | 0x8C114006 | 페어링 모드가 최대 시간을 초과했습니다. 페어링을 다시 시작하고 2분 이내에 PIN을 입력하세요.               | [XBOX PC Remote Iteration API 오류 코드](/reference/remoting/error-codes) | PIN 페어링 프로세스를 다시 시작하고, 시간 초과(2분) 전에 클라이언트 장치에서 PIN을 입력하세요.                                               |
| E\_TOOMANYFAILURES        | 0x8C114007 | PIN 입력 실패 횟수가 너무 많습니다. 페어링을 다시 시작하고 올바른 PIN을 입력하세요.                  | [XBOX PC Remote Iteration API 오류 코드](/reference/remoting/error-codes) | PIN 페어링 프로세스를 다시 시작하고 클라이언트 장치에서 올바른 PIN을 입력하세요.                                                         |
| E\_CLIENTNOTAUTHORIZED    | 0x8C114008 | 장치가 클라이언트를 거부했습니다. 페어링을 성공적으로 완료한 후 연결을 다시 시도하세요.                    | [XBOX PC Remote Iteration API 오류 코드](/reference/remoting/error-codes) | PIN 페어링 프로세스를 성공적으로 완료하고 연결 요청을 다시 실행하세요.                                                                |
| E\_SERVERNOTAUTHORIZED    | 0x8C114009 | 클라이언트가 장치를 거부했습니다. 페어링을 성공적으로 완료한 후 연결을 다시 시도하세요.                    | [XBOX PC Remote Iteration API 오류 코드](/reference/remoting/error-codes) | PIN 페어링 프로세스를 성공적으로 완료하고 연결 요청을 다시 실행하세요.                                                                |
| E\_SSHKEYTOOLARGE         | 0x8C11400A | SSH 키가 너무 큽니다. 지원되는 키 유형/크기를 생성한 후 해당 키로 다시 시도하세요.                   | [XBOX PC Remote Iteration API 오류 코드](/reference/remoting/error-codes) | 지원되는 알고리즘과 크기(예: ED25519 또는 RSA‑2048)를 사용하여 새 SSH 키를 생성하고, RIT 연결에 올바른 키가 지정되었는지 확인하세요.                  |
| E\_GAMENOTSUSPENDED       | 0x8C11400B | 지정된 프로세스를 재개할 수 없습니다. resume을 호출하기 전에 프로세스가 일시 중단된 상태인지 확인하세요.       | [XBOX PC Remote Iteration API 오류 코드](/reference/remoting/error-codes) | 재개하기 전에 프로세스 상태를 확인하고, 다른 도구가 이미 프로세스를 재개하거나 종료하지 않았는지 확인하세요.                                            |
| E\_GAMENOTRUNNING         | 0x8C11400C | 실행 중인 게임 프로세스가 없습니다. 게임 프로세스 관련 작업을 호출하기 전에 게임을 실행하세요.               | [XBOX PC Remote Iteration API 오류 코드](/reference/remoting/error-codes) | 현재 실행 중인 프로세스를 확인하고, 게임 프로세스에 의존하는 API를 실행하기 전에 게임을 실행하세요.                                               |
| E\_GAMEOVERSUSPENDED      | 0x8C11400D | 스레드 일시 중단 카운트가 0이 아닙니다. 일시 중단 카운트가 0으로 돌아올 때까지 재개하거나 프로세스를 다시 시작하세요. | [XBOX PC Remote Iteration API 오류 코드](/reference/remoting/error-codes) | 일시 중단 카운트가 0에 도달할 때까지 스레드를 반복적으로 재개하거나 프로세스를 다시 시작하여 스레드 상태를 재설정하세요.; 또는 프로세스를 다시 시작하여 스레드 상태를 재설정하세요.   |
| E\_GAMESTILLRUNNING       | 0x8C11400E | 한 번에 하나의 게임만 실행할 수 있습니다. 다른 게임을 실행하기 전에 현재 실행 중인 게임을 중지하세요.          | [XBOX PC Remote Iteration API 오류 코드](/reference/remoting/error-codes) | 이전 게임 프로세스가 실행 중이 아닌지 확인하고, 실행 중인 게임(있는 경우)을 종료한 후 다른 게임을 실행하고, 게임 프로세스를 다시 실행해 보세요.                     |
| E\_GAMEEXITABANDONED      | 0x8C11400F | 게임 종료 대기가 중단되었습니다. PID/TID를 확인한 후 종료를 다시 시도하세요.                      | [XBOX PC Remote Iteration API 오류 코드](/reference/remoting/error-codes) | 게임 프로세스가 여전히 실행 중인지 확인하고, 올바른 프로세스 ID와 스레드 ID가 종료에 제공되었는지 확인한 후 프로세스 종료를 다시 시도하세요.                       |
| E\_GAMEFILEPATHNOTEXIST   | 0x8C114010 | 게임 파일 경로가 존재하지 않습니다. 원격 경로를 확인하고 배포가 성공했는지 확인하세요.                    | [XBOX PC Remote Iteration API 오류 코드](/reference/remoting/error-codes) | 원격 장치에 경로가 존재하는지 확인하고, 배포가 성공했는지 확인하세요.                                                                  |
| E\_SERVERTOOOLD           | 0x8C114011 | 이 클라이언트에 대해 서버 버전이 너무 오래되었습니다. 원격 컴퓨터의 `wdEndpoint`를 업데이트하세요.        | [XBOX PC Remote Iteration API 오류 코드](/reference/remoting/error-codes) | 원격 컴퓨터의 wdEndpoint를 최신 버전으로 업데이트하세요.                                                                     |
| E\_NAMERESOLUTIONFAILED   | 0x8C114012 | 원격 컴퓨터 이름을 확인할 수 없습니다. 호스트 이름과 DNS를 확인하거나 IP 주소로 테스트하세요.             | [XBOX PC Remote Iteration API 오류 코드](/reference/remoting/error-codes) | 호스트 이름 철자, DNS 구성, 네트워크 연결을 확인하고, 이름 확인 문제를 격리하기 위해 IP 주소를 사용하세요.                                        |
| E\_INVALIDADDRESS         | 0x8C114013 | 잘못된 주소입니다. 주소 형식을 수정하고 유효한 IPv4 주소를 사용하세요.                           | [XBOX PC Remote Iteration API 오류 코드](/reference/remoting/error-codes) | 올바른 IP 주소를 확인하고, 주소 형식을 수정하여 IPv4 프로토콜을 사용하도록 하세요.                                                       |
| E\_CONNECTIONERROR        | 0x8C114014 | 연결에 실패했습니다. 네트워크/방화벽/서비스 가용성을 확인한 후 다시 시도하세요.                        | [XBOX PC Remote Iteration API 오류 코드](/reference/remoting/error-codes) | 원격 컴퓨터의 네트워크 연결, 방화벽 규칙, 서비스 가용성을 확인하고, 장치 간의 가시성을 확인하여 서로 ping이 가능한지 확인한 후, 로깅을 활성화한 상태에서 연결을 다시 시도하세요. |
| E\_LISTENERALREADYRUNNING | 0x8C114015 | 다른 리스너가 활성 상태입니다. 기존 엔드포인트 인스턴스를 중지하거나 재사용하세요.                       | [XBOX PC Remote Iteration API 오류 코드](/reference/remoting/error-codes) | - 새 엔드포인트 인스턴스를 실행하기 전에 기존 실행 중인 인스턴스를 중지하거나, 새 인스턴스를 실행하는 대신 이미 실행 중인 엔드포인트 인스턴스를 사용하세요.                |
| E\_ADMIN\_REQUIRED        | 0x8C114016 | 관리자 권한이 필요합니다. 엔드포인트를 관리자 권한으로 실행하세요.                                | [XBOX PC Remote Iteration API 오류 코드](/reference/remoting/error-codes) | 엔드포인트를 관리자 권한으로 다시 실행하세요.                                                                                |
| E\_INVALIDTHREADID        | 0x8C114017 | 잘못된 스레드 ID입니다. 숫자 형식의 스레드 ID를 제공하세요.                                 | [XBOX PC Remote Iteration API 오류 코드](/reference/remoting/error-codes) | 숫자만 포함된 유효한 스레드 ID를 제공하세요.                                                                               |
| E\_INVALIDPIDTID\_PAIR    | 0x8C114018 | 프로세스 ID가 스레드 ID와 연결되어 있지 않습니다. 해당 프로세스의 스레드를 다시 조회한 후 재시도하세요.        | [XBOX PC Remote Iteration API 오류 코드](/reference/remoting/error-codes) | 프로세스에서 스레드 목록을 다시 조회하고, ID가 캐시되었거나 오래된 것이 아닌지 확인하며, 스레드 ID가 올바른 프로세스 컨텍스트에서 획득되었는지 검증하세요.                |
| E\_THREADNOTFOUND         | 0x8C114019 | 스레드를 찾을 수 없습니다. 현재 스레드 ID를 다시 조회하고 오래되지 않은 ID로 다시 시도하세요.             | [XBOX PC Remote Iteration API 오류 코드](/reference/remoting/error-codes) | 프로세스에서 스레드 목록을 다시 조회하고, ID가 캐시되었거나 오래된 것이 아닌지 확인하며, 스레드 ID가 올바른 프로세스 컨텍스트에서 획득되었는지 검증하세요.                |

## XAPU

| 코드                              | 값          | 설명                                                     | 출처                                                | 문제 해결                                                  |
| ------------------------------- | ---------- | ------------------------------------------------------ | ------------------------------------------------- | ------------------------------------------------------ |
| XAPU\_E\_QUEUE\_FULL            | 0x8AC81000 | XAPU 명령 큐가 가득 찼습니다.                                    | [XAPU 오류](/reference/audio/xapu/enums/xapuerrors) | XAPU 명령 큐가 가득 찼습니다.                                    |
| XAPU\_E\_PENDING\_RESULTS       | 0x8AC81001 | 현재 사용 가능한 결과가 없습니다.                                    | [XAPU 오류](/reference/audio/xapu/enums/xapuerrors) | 현재 사용 가능한 결과가 없습니다.                                    |
| XAPU\_E\_INVALID\_COMMAND       | 0x8AC81002 | 잘못된 XAPU 명령 값입니다.                                      | [XAPU 오류](/reference/audio/xapu/enums/xapuerrors) | 잘못된 XAPU 명령 값입니다.                                      |
| XAPU\_E\_INVALID\_STREAM\_INDEX | 0x8AC81003 | 제출된 XAPU 명령의 스트림 인덱스가 잘못되었습니다.                         | [XAPU 오류](/reference/audio/xapu/enums/xapuerrors) | 제출된 XAPU 명령의 스트림 인덱스가 잘못되었습니다.                         |
| XAPU\_E\_NO\_DEVICE\_RESOURCES  | 0x8AC81004 | 요청된 스트림 수를 지원하기에 시스템 리소스가 충분하지 않습니다.                   | [XAPU 오류](/reference/audio/xapu/enums/xapuerrors) | 요청된 스트림 수를 지원하기에 시스템 리소스가 충분하지 않습니다.                   |
| XAPU\_E\_ALREADY\_ACTIVE        | 0x8AC81005 | 스트림이 이미 활성 상태입니다.                                      | [XAPU 오류](/reference/audio/xapu/enums/xapuerrors) | 스트림이 이미 활성 상태입니다.                                      |
| XAPU\_E\_BUFFER\_TOO\_SMALL     | 0x8AC81006 | 출력 버퍼가 데이터를 담기에 너무 작습니다.                               | [XAPU 오류](/reference/audio/xapu/enums/xapuerrors) | 출력 버퍼가 데이터를 담기에 너무 작습니다.                               |
| XAPU\_E\_PROCESSING\_ERROR      | 0x8AC81007 | 하드웨어가 명령을 처리하지 못했습니다.                                  | [XAPU 오류](/reference/audio/xapu/enums/xapuerrors) | 하드웨어가 명령을 처리하지 못했습니다.                                  |
| XAPU\_E\_BAD\_OPUS\_PACKET      | 0x8AC81008 | 하드웨어에서 Opus 패킷을 디코딩할 때 오류가 발생했습니다. 인코딩에 오류가 있는지 확인하세요. | [XAPU 오류](/reference/audio/xapu/enums/xapuerrors) | 하드웨어에서 Opus 패킷을 디코딩할 때 오류가 발생했습니다. 인코딩에 오류가 있는지 확인하세요. |
| XAPU\_E\_DEVICE\_FAULT          | 0x8AC81050 | 복구할 수 없는 펌웨어 충돌이 발생했습니다.                               | [XAPU 오류](/reference/audio/xapu/enums/xapuerrors) | 복구할 수 없는 펌웨어 충돌이 발생했습니다.                               |
| XAPU\_E\_DEVICE\_TIMEOUT        | 0x8AC81051 | 하드웨어가 제 시간에 응답하지 않았습니다.                                | [XAPU 오류](/reference/audio/xapu/enums/xapuerrors) | 하드웨어가 제 시간에 응답하지 않았습니다.                                |
| XAPU\_E\_DEVICE\_FATAL\_ERROR   | 0x8AC81052 | 하드웨어에서 오류가 발생하여 연결을 다시 설정해야 합니다.                       | [XAPU 오류](/reference/audio/xapu/enums/xapuerrors) | 하드웨어에서 오류가 발생하여 연결을 다시 설정해야 합니다.                       |

## XDSP

| 코드                                                   | 값          | 설명                                                                                                                                                                                     | 출처                                                     | 문제 해결                                                                                                                                                                                  |
| ---------------------------------------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| XDSP\_E\_QUEUE\_FULL                                 | 0x8AC810A0 | 명령 큐가 가득 찼습니다. 더 많은 명령을 제출하기 전에 하드웨어가 현재 제출된 명령의 처리를 완료할 수 있도록 충분히 기다려 주세요.                                                                                                            | [XDSP 오류](/reference/audio/xdspaudio/enums/xdsperrors) | 명령 큐가 가득 찼습니다. 더 많은 명령을 제출하기 전에 하드웨어가 현재 제출된 명령의 처리를 완료할 수 있도록 충분히 기다려 주세요.                                                                                                            |
| XDSP\_E\_PENDING\_RESULTS                            | 0x8AC810A1 | 제출된 명령의 모든 결과를 수신하기 전에 XDspStream이 비활성화되었습니다. 스트림을 비활성화하기 전에 하드웨어가 스트림에 제출된 명령의 처리를 완료할 수 있도록 충분히 기다려 주세요.                                                                             | [XDSP 오류](/reference/audio/xdspaudio/enums/xdsperrors) | 제출된 명령의 모든 결과를 수신하기 전에 XDspStream이 비활성화되었습니다. 스트림을 비활성화하기 전에 하드웨어가 스트림에 제출된 명령의 처리를 완료할 수 있도록 충분히 기다려 주세요.                                                                             |
| XDSP\_E\_NO\_DEVICE\_RESOURCES                       | 0x8AC810A2 | 요청을 처리할 수 있는 XDSP 장치 리소스가 없습니다.                                                                                                                                                        | [XDSP 오류](/reference/audio/xdspaudio/enums/xdsperrors) | 요청을 처리할 수 있는 XDSP 장치 리소스가 없습니다.                                                                                                                                                        |
| XDSP\_E\_DEVICE\_FATAL\_ERROR                        | 0x8AC810A3 | 현재 처리 중인 명령에서 치명적인 오류가 발생했습니다(예: 충돌/응답 없음). 어떤 명령 시퀀스가 실패했는지 확인하려면 [XDspStatus](/reference/audio/xdspaudio/structs/xdspstatus) 구조체를 확인하세요. 하드웨어에는 자동 복구 메커니즘이 있어 후속 명령을 계속 처리할 수 있습니다. | [XDSP 오류](/reference/audio/xdspaudio/enums/xdsperrors) | 현재 처리 중인 명령에서 치명적인 오류가 발생했습니다(예: 충돌/응답 없음). 어떤 명령 시퀀스가 실패했는지 확인하려면 [XDspStatus](/reference/audio/xdspaudio/structs/xdspstatus) 구조체를 확인하세요. 하드웨어에는 자동 복구 메커니즘이 있어 후속 명령을 계속 처리할 수 있습니다. |
| XDSP\_E\_NOT\_ALL\_HANDLES\_DEACTIVATED              | 0x8AC810A4 | 클라이언트와 연결된 모든 XDspStream 객체가 비활성화되기 전에 XDspClient에 대해 [XDspDisconnect](/reference/audio/xdspaudio/functions/xdspdisconnect)가 호출되었습니다.                                                  | [XDSP 오류](/reference/audio/xdspaudio/enums/xdsperrors) | 클라이언트와 연결된 모든 XDspStream 객체가 비활성화되기 전에 XDspClient에 대해 [XDspDisconnect](/reference/audio/xdspaudio/functions/xdspdisconnect)가 호출되었습니다.                                                  |
| XDSP\_E\_MAX\_CLIENTS\_EXCEEDED                      | 0x8AC810A5 | 이미 최대 개수의 XDspClient가 생성되었습니다.                                                                                                                                                         | [XDSP 오류](/reference/audio/xdspaudio/enums/xdsperrors) | 이미 최대 개수의 XDspClient가 생성되었습니다.                                                                                                                                                         |
| XDSP\_E\_MAX\_AGGREGATE\_IMPULSE\_RESPONSE\_EXCEEDED | 0x8AC810A6 | 현재 [XDspConnect](/reference/audio/xdspaudio/functions/xdspconnect) 호출은 XDSP가 지원되는 최대 집계 임펄스 응답 길이를 초과하도록 만들므로 유효하지 않습니다.                                                               | [XDSP 오류](/reference/audio/xdspaudio/enums/xdsperrors) | 현재 [XDspConnect](/reference/audio/xdspaudio/functions/xdspconnect) 호출은 XDSP가 지원되는 최대 집계 임펄스 응답 길이를 초과하도록 만들므로 유효하지 않습니다.                                                               |
| XDSP\_E\_INVALID\_IMPULSE\_RESPONSE\_LENGTH          | 0x8AC810A7 | 임펄스 응답 길이가 너무 크거나 너무 작은 상태로 [XDspActivate](/reference/audio/xdspaudio/functions/xdspactivate)가 호출되었습니다.                                                                                | [XDSP 오류](/reference/audio/xdspaudio/enums/xdsperrors) | 임펄스 응답 길이가 너무 크거나 너무 작은 상태로 [XDspActivate](/reference/audio/xdspaudio/functions/xdspactivate)가 호출되었습니다.                                                                                |


## Related topics

- [XBOX PC Remote Iteration API](/ko/reference/remoting/remoteiteration_members.md)
- [XGameSaveFiles](/ko/reference/system/xgamesavefiles/xgamesavefiles_members.md)
- [XGameUI](/ko/reference/system/xgameui/xgameui_members.md)
- [XAppCapture 오류 코드](/ko/reference/system/xappcapture/xappcapture_errors.md)
- [XBOX Live HRESULT 오류 코드](/ko/reference/live/xbl-hresult-error-codes.md)
