Skip to main content

XPackageEnumeratePackages

이미 설치되어 있거나 설치 중이고 호출 프로세스와 관련된 패키지를 찾습니다.

구문

매개 변수

kind   _In_
형식: XPackageKind
열거할 설치 패키지의 유형입니다. scope   _In_
형식: XPackageEnumerationScope
설치 패키지의 범위입니다. context   _In_opt_
형식: void*
callback 매개 변수에 지정된 콜백에 전달할 컨텍스트입니다. callback   _In_
형식: XPackageEnumerationCallback*
완료 시 호출할 콜백입니다.

반환 값

형식: HRESULT HRESULT 성공 또는 오류 코드입니다.

설명

이 함수는 시간에 민감한 스레드에서 호출해서는 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
XPackageEnumeratePackages를 사용하면 이미 설치되어 있거나 설치 중이고 호출 프로세스와 관련된 패키지를 찾을 수 있습니다. 이 함수는 콘텐츠 패키지와 앱 패키지를 모두 찾을 수 있습니다. XPackageDetails 구조체를 통해 설치에 대한 세부 정보를 제공합니다. 패키지가 아직 설치 중인 경우 installing 속성이 true로 설정되며, 설치 모니터를 만들어 패키지 식별자로 설치 진행률을 모니터링할 수 있습니다. 일반적인 설치 큐 알림은 없으며, 진행 중인 항목을 표시하고 추적하려면 XPackageEnumeratePackages를 사용하는 것이 좋습니다. 또한 설치를 중지, 시작 또는 취소하는 API도 없습니다. 게임의 관점에서는 설치가 자체적으로 처리되어야 합니다. 오류는 자동으로 재시도되며 게임에는 표시되지 않습니다. XPackageKind::Game 값으로 호출된 API의 출력은 XPackageEnumerationScope 값에 따라 다음과 같습니다. XPackageKind::Content 값으로 호출된 API의 출력은 XPackageEnumerationScope 값에 따라 다음과 같습니다. 예제:

요구 사항

헤더: XPackage.h 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

개념 문서

함께 보기

XPackage
프랜차이즈 게임 허브
PC 및 XBOX One용 다운로드 가능 콘텐츠 패키지(DLC)를 만들고 사용하는 방법
마지막 수정일 2026년 8월 24일