Skip to main content

XStoreAcquireLicenseForDurablesAsync

DLC(패키지가 있는 Durable), 패키지가 없는 Durable 또는 Durable 추가 기능 제품에 대한 라이선스를 획득합니다.

구문

매개 변수

storeContextHandle   _In_
형식: XStoreContextHandle
XStoreCreateContext가 반환한 사용자의 스토어 컨텍스트 핸들입니다. storeId   _In_z_
형식: char*
라이선스를 획득할 durable의 스토어 ID입니다. async   _Inout_
형식: XAsyncBlock*
비동기 작업을 정의하는 XAsyncBlock입니다. XAsyncBlock을 사용하여 호출 상태를 확인하고 호출 결과를 가져옵니다. 자세한 내용은 XAsyncBlock을 참조하세요.

반환 값

형식: HRESULT 성공하면 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다.

설명

이 API는 요청된 durable에 대한 라이선스 획득을 시도합니다. 디바이스가 처음으로 라이선스를 획득하는 경우 서비스 호출이 이루어지므로 온라인 연결이 필요합니다. 캐싱으로 인해 동일한 라이선스에 대한 후속 호출은 더 빠를 수 있지만 라이선스는 언제든지 무효화될 수 있습니다. 콘솔에서 오프라인 액세스를 하려면 소유 계정에 대해 ‘Home XBOX’가 사용하도록 설정되어야 하고 라이선스는 먼저 온라인 상태에서 한 번 얻어야 합니다. PC의 경우 오프라인 액세스를 하려면 라이선스를 소유하는 계정에 대해 ‘오프라인 사용 권한’이 설정되어야 하고 라이선스는 먼저 온라인 상태에서 한 번 얻어야 합니다. XStoreRegisterPackageLicenseLost를 사용하여 이 API에서 얻은 라이선스가 손실되었는지 모니터링할 수 있습니다.

요구 사항

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

개념 설명서

참고 항목

XStore
XAsyncBlock
XStoreAcquireLicenseForDurablesResult
How to use a durable without a package
Granting players access to add-on content
마지막 수정일 2026년 8월 24일