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

# XPackage

> XPackage

# XPackage

XPackage API에 대한 참조 자료입니다.

## 함수

| 함수                                                                                                                                  | 설명                                                                                                                                            |
| ----------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| [XPackageChangeChunkInstallOrder](/reference/system/xpackage/functions/xpackagechangechunkinstallorder)                             | 선택한 청크를 먼저 설치하도록 설정합니다.                                                                                                                       |
| [XPackageChunkAvailabilityCallback](/reference/system/xpackage/functions/xpackagechunkavailabilitycallback)                         | [XPackageEnumerateChunkAvailability](/reference/system/xpackage/functions/xpackageenumeratechunkavailability)에서 사용하는 사용자 정의 콜백입니다.            |
| [XPackageCloseInstallationMonitorHandle](/reference/system/xpackage/functions/xpackagecloseinstallationmonitorhandle)               | 지정된 설치 모니터를 닫습니다.                                                                                                                             |
| [XPackageCloseMountHandle](/reference/system/xpackage/functions/xpackageclosemounthandle)                                           | 지정된 탑재 핸들을 닫습니다.                                                                                                                              |
| [XPackageCreateInstallationMonitor](/reference/system/xpackage/functions/xpackagecreateinstallationmonitor)                         | 설치 상태를 모니터링하는 모니터를 만듭니다.                                                                                                                      |
| [XPackageEnumerateChunkAvailability](/reference/system/xpackage/functions/xpackageenumeratechunkavailability)                       | 설치 패키지를 조사하고 지정된 선택자와 일치하는 모든 청크의 가용성을 열거합니다.                                                                                                 |
| [XPackageEnumerateFeatures](/reference/system/xpackage/functions/xpackageenumeratefeatures)                                         | 패키지의 레이아웃 파일에 정의된 기능을 열거합니다.                                                                                                                  |
| [XPackageEnumeratePackages](/reference/system/xpackage/functions/xpackageenumeratepackages)                                         | 호출 프로세스와 관련된 설치된 패키지 또는 설치 중인 패키지를 찾습니다.                                                                                                      |
| [XPackageEnumerationCallback](/reference/system/xpackage/functions/xpackageenumerationcallback)                                     | [XPackageEnumeratePackages](/reference/system/xpackage/functions/xpackageenumeratepackages)에서 사용하는 콜백입니다.                                     |
| [XPackageEstimateDownloadSize](/reference/system/xpackage/functions/xpackageestimatedownloadsize)                                   | 지정된 설치 선택자와 일치하는 청크의 다운로드 크기를 계산합니다.                                                                                                          |
| [XPackageFeatureEnumerationCallback](/reference/system/xpackage/functions/xpackagefeatureenumerationcallback)                       | XPackageEnumerateFeatures에서 각 기능을 열거하는 데 사용하는 콜백입니다.                                                                                          |
| [XPackageFindChunkAvailability](/reference/system/xpackage/functions/xpackagefindchunkavailability)                                 | 지정된 선택자와 일치하는 청크 컬렉션의 최소 가용성을 반환합니다.                                                                                                          |
| [XPackageGetCurrentProcessPackageIdentifier](/reference/system/xpackage/functions/xpackagegetcurrentprocesspackageidentifier)       | 이 프로세스의 설치를 식별하는 설치 ID 문자열을 반환합니다.                                                                                                            |
| [XPackageGetInstallationProgress](/reference/system/xpackage/functions/xpackagegetinstallationprogress)                             | 설치의 현재 진행률을 반환합니다.                                                                                                                            |
| [XPackageGetMountPath](/reference/system/xpackage/functions/xpackagegetmountpath)                                                   | 탑재된 설치의 경로를 가져옵니다.                                                                                                                            |
| [XPackageGetMountPathSize](/reference/system/xpackage/functions/xpackagegetmountpathsize)                                           | [XPackageGetMountPath](/reference/system/xpackage/functions/xpackagegetmountpath)에서 반환된 탑재 경로를 담을 배열에 필요한 크기를 가져옵니다.                          |
| [XPackageGetUserLocale](/reference/system/xpackage/functions/xpackagegetuserlocale)                                                 | 현재 사용자 로캘을 가져옵니다.                                                                                                                             |
| [XPackageGetWriteStats](/reference/system/xpackage/functions/xpackagegetwritestats)                                                 | 출력 쓰기 통계(writeStats)를 가져옵니다.                                                                                                                  |
| [XPackageInstallationProgressCallback](/reference/system/xpackage/functions/xpackageinstallationprogresscallback)                   | [XPackageRegisterInstallationProgressChanged](/reference/system/xpackage/functions/xpackageregisterinstallationprogresschanged)에서 사용하는 콜백입니다. |
| [XPackageInstallChunks](/reference/system/xpackage/functions/xpackageinstallchunks)                                                 | 청크 설치를 시작합니다.                                                                                                                                 |
| [XPackageInstallChunksAsync](/reference/system/xpackage/functions/xpackageinstallchunksasync)                                       | 청크 설치를 시작합니다.                                                                                                                                 |
| [XPackageInstallChunksResult](/reference/system/xpackage/functions/xpackageinstallchunksresult)                                     | [XPackageInstallChunksAsync](/reference/system/xpackage/functions/xpackageinstallchunksasync) 호출의 결과를 검색합니다.                                  |
| [XPackageInstalledCallback](/reference/system/xpackage/functions/xpackageinstalledcallback)                                         | XPackageRegisterPackageInstalled 함수에서 사용하는 사용자 정의 콜백입니다.                                                                                      |
| [XPackageIsPackagedProcess](/reference/system/xpackage/functions/xpackageispackagedprocess)                                         | 현재 프로세스에 설치 ID가 있는지 여부를 나타내는 부울을 반환합니다.                                                                                                       |
| [XPackageMount](/reference/system/xpackage/functions/xpackagemount)                                                                 | 이 함수는 이제 사용되지 않습니다. 대신 XPackageMountWithUiAsync를 사용하세요.                                                                                       |
| [XPackageMountWithUiAsync](/reference/system/xpackage/functions/xpackagemountwithuiasync)                                           | 지정된 콘텐츠의 설치를 비동기적으로 탑재하고 이에 대한 탑재 핸들을 반환합니다.                                                                                                  |
| [XPackageMountWithUiResult](/reference/system/xpackage/functions/xpackagemountwithuiresult)                                         | XPackageMountWithUIAsync 호출의 결과를 가져옵니다.                                                                                                       |
| [XPackageRegisterInstallationProgressChanged](/reference/system/xpackage/functions/xpackageregisterinstallationprogresschanged)     | 설치 진행률이 변경될 때 호출할 콜백을 등록합니다.                                                                                                                  |
| [XPackageRegisterPackageInstalled](/reference/system/xpackage/functions/xpackageregisterpackageinstalled)                           | 설치가 완료될 때 호출할 콜백을 등록합니다.                                                                                                                      |
| [XPackageUninstallPackage](/reference/system/xpackage/functions/xpackageuninstallpackage)                                           | 지정된 패키지를 제거합니다.                                                                                                                               |
| [XPackageUninstallChunks](/reference/system/xpackage/functions/xpackageuninstallchunks)                                             | 지정된 선택자와 일치하는 청크를 제거합니다.                                                                                                                      |
| [XPackageUninstallUWPInstance](/reference/system/xpackage/functions/xpackageuninstalluwpinstance)                                   | 현재 사용자에 대해 특정 패키지의 유니버설 Windows 플랫폼(UWP) 인스턴스가 현재 설치되어 있으면 이를 제거합니다.                                                                          |
| [XPackageUnregisterInstallationProgressChanged](/reference/system/xpackage/functions/xpackageunregisterinstallationprogresschanged) | 이전에 등록된 설치 진행률 변경 콜백을 등록 취소합니다.                                                                                                               |
| [XPackageUnregisterPackageInstalled](/reference/system/xpackage/functions/xpackageunregisterpackageinstalled)                       | 이전에 등록된 설치 완료 콜백을 등록 취소합니다.                                                                                                                   |
| [XPackageUpdateInstallationMonitor](/reference/system/xpackage/functions/xpackageupdateinstallationmonitor)                         | [XPackageGetInstallationProgress](/reference/system/xpackage/functions/xpackagegetinstallationprogress)에서 반환된 진행률을 새로 고칩니다.                   |

## 구조체

| 구조체                                                                                             | 설명                           |
| ----------------------------------------------------------------------------------------------- | ---------------------------- |
| [XPackageChunkSelector](/reference/system/xpackage/structs/xpackagechunkselector)               | 청크 집합을 선택하는 기준을 정의합니다.       |
| [XPackageDetails](/reference/system/xpackage/structs/xpackagedetails)                           | 설치에 대한 세부 정보를 포함합니다.         |
| [XPackageFeature](/reference/system/xpackage/structs/xpackagefeature)                           | 기능을 설명합니다.                   |
| [XPackageInstallationProgress](/reference/system/xpackage/structs/xpackageinstallationprogress) | 설치 진행률에 대한 정보를 포함합니다.        |
| [XPackageWriteStats](/reference/system/xpackage/structs/xpackagewritestats)                     | 출력 쓰기 통계(writeStats)를 포함합니다. |

## 열거형

| 열거형                                                                                     | 설명                                |
| --------------------------------------------------------------------------------------- | --------------------------------- |
| [XPackageChunkAvailability](/reference/system/xpackage/enums/xpackagechunkavailability) | 설치 청크의 가용성을 나타냅니다.                |
| [XPackageChunkSelectorType](/reference/system/xpackage/enums/xpackagechunkselectortype) | 선택자 형식을 나타냅니다.                    |
| [XPackageEnumerationScope](/reference/system/xpackage/enums/xpackageenumerationscope)   | 설치 패키지가 열거될 때 반환될 패키지의 범위를 나타냅니다. |
| [XPackageKind](/reference/system/xpackage/enums/xpackagekind)                           | 설치 패키지의 유형을 나타냅니다.                |

## 오류 코드

다음 오류 코드는 XPackage API에서 반환될 수 있습니다. 전체 목록은 [오류 코드](/reference/errorcodes)를 참조하세요.

| 코드                                       | 값          | 설명                                                                                        |
| ---------------------------------------- | ---------- | ----------------------------------------------------------------------------------------- |
| E\_GAMEPACKAGE\_APP\_NOT\_PACKAGED       | 0x89245200 | 게임이 컨테이너에 패키징되지 않았습니다.                                                                    |
| E\_GAMEPACKAGE\_NO\_INSTALLED\_LANGUAGES | 0x89245201 | 게임은 Intelligent Delivery를 사용하여 언어를 선택적으로 설치하지만 설치된 언어가 없습니다.                              |
| E\_GAMEPACKAGE\_NO\_STORE\_ID            | 0x89245202 | 애플리케이션의 게임 구성에 StoreId 특성을 설정해야 합니다.                                                      |
| E\_GAMEPACKAGE\_INVALID\_SELECTOR        | 0x89245203 | 패키지의 청크로 확인되지 않는 청크 선택자가 제공되었습니다.                                                         |
| E\_GAMEPACKAGE\_DOWNLOAD\_REQUIRED       | 0x89245204 | 이 디바이스에 패키지를 탑재하려면 하나 이상의 필수 청크를 다운로드해야 합니다.                                              |
| E\_GAMEPACKAGE\_NO\_TAG\_CHANGE          | 0x89245205 | 태그가 아닌 기능(Features)을 사용하여 이 패키지에 설치된 청크를 변경합니다.                                           |
| E\_GAMEPACKAGE\_DLC\_NOT\_SUPPORTED      | 0x89245206 | 게임이 DLC 패키지를 지원하지 않습니다. 게임 구성에서 올바른 DLC 호환성을 확인하세요.                                       |
| E\_GAMEPACKAGE\_DUPLICATE\_ID\_VALUES    | 0x89245207 | 패키지에 동일한 'ID' 특성에 매핑되는 실행 파일이 두 개 이상 포함되어 있습니다. 'Executable' 요소에서 중복된 'ID' 특성이 있는지 확인하세요. |
| E\_GAMEPACKAGE\_NO\_PACKAGE\_IDENTIFIER  | 0x89245208 | 패키지에 대한 식별자를 확인할 수 없습니다. 패키지가 설치되지 않았을 수 있습니다.                                            |

## 개념 문서

* [XStore 업데이트 확인](https://learn.microsoft.com/gaming/gdk/docs/store/commerce/fundamentals/xstore-checking-for-updates)
* [XStore 콘텐츠 액세스 권한 부여](https://learn.microsoft.com/gaming/gdk/docs/store/commerce/fundamentals/xstore-granting-access-to-content)
* [XStore 선택적 패키지 관리 및 라이선스](https://learn.microsoft.com/gaming/gdk/docs/store/commerce/fundamentals/xstore-manage-and-license-optional-packages)

## 함께 보기

[시스템 API 참조](/reference/system/gc-reference-system-toc)\
[XStore API 참조](/reference/system/xstore/xstore_members)


## Related topics

- [XPackageUninstallPackage](/ko/reference/system/xpackage/functions/xpackageuninstallpackage.md)
- [XPackageEnumeratePackages](/ko/reference/system/xpackage/functions/xpackageenumeratepackages.md)
- [XPackageRegisterPackageInstalled](/ko/reference/system/xpackage/functions/xpackageregisterpackageinstalled.md)
- [XPackageUnregisterPackageInstalled](/ko/reference/system/xpackage/functions/xpackageunregisterpackageinstalled.md)
- [XPackageDetails](/ko/reference/system/xpackage/structs/xpackagedetails.md)
