Skip to main content

XPackageMountWithUiAsync

지정된 콘텐츠의 설치를 비동기적으로 탑재하고 이에 대한 탑재 핸들을 반환합니다. 로그인한 모든 사용자의 자녀 보호 설정을 기준으로 콘텐츠에 연령 제한이 있는 경우 사용자에게 자녀 보호 동의 UI를 표시합니다.

구문

매개 변수

packageIdentifier  _In_z_
형식: const char *
디스크에 설치된 패키지를 고유하게 식별하는 문자열입니다. XPackageEnumerationCallback에서 반환된 XPackageDetails 구조체의 packageIdentifier 필드를 전달합니다. 패키지 식별자에 대한 자세한 내용은 다운로드 가능한 콘텐츠(DLC) 관리 및 라이선스를 참조하세요. async  _Inout_
형식: XAsyncBlock *
비동기 호출의 상태를 모니터링하기 위한 XAsyncBlock입니다.

반환 값

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

설명

이 API는 로그인된 모든 사용자에게 연령에 적합하지 않은 콘텐츠를 탑재하는 경우 사용자에게 자녀 보호 동의 프롬프트를 표시합니다. 성인 사용자가 프롬프트에서 자녀 보호 동의를 승인하면 API가 패키지 탑재를 시도합니다. 성인 사용자가 프롬프트에서 자녀 보호 동의를 거부하면 API는 패키지 탑재에 실패합니다. 이 API는 XStoreAcquireLicenseForPackageAsync / ResultXStoreIsLicenseValid를 자동으로 호출합니다. API가 DLC에 대해 유효한 라이선스를 획득할 수 없으면 탑재에 실패합니다. 이 코드 예제에서 게임은 콘텐츠가 연령 제한이 있는 경우 DLC를 흑백으로 렌더링합니다. 게임의 외부 코드는 사용자가 사용할 DLC를 선택할 때 MountDlc를 호출합니다.

요구 사항

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

개념 문서

함께 보기

XPackageMountWithUiResult XPackage
XPackageEnumeratePackages
XPackageEnumerationCallback
XPackageDetails
XPackageGetMountPath
XPackageGetMountPathSize
PC 및 XBOX One용 다운로드 가능 콘텐츠 패키지(DLC)를 만들고 사용하는 방법
마지막 수정일 2026년 8월 24일