XStoreAcquireLicenseForDurablesAsync
패키지 또는 지속성 추가 콘텐츠 제품 없이 지속성에 대한 라이선스를 취득합니다.
참고 항목
이 API는 패키지 제품 유형이 있는 지속성 콘텐츠에 대해 작동하지 않습니다. 패키지가 포함된 지속성 콘텐츠에 대해 이 API를 호출하려고 하면 XStoreAcquireLicenseForDurablesResult에서 오류를 반환합니다. 패키지가 포함된 지속성 콘텐츠의 라이선스를 가져오려면 XStoreAcquireLicenseForPackageAsync를 사용합니다.
구문
HRESULT XStoreAcquireLicenseForDurablesAsync(
const XStoreContextHandle storeContextHandle,
const char* storeId,
XAsyncBlock* async
)
매개 변수
storeContextHandle _In_
형식: XStoreContextHandle
XStoreCreateContext가 반환하는 사용자의 Microsoft Store 컨텍스트 핸들입니다.
storeId _In_z_
형식: char*
라이선스를 확보하는 데 사용할 수 있는 저장소 ID입니다.
async _Inout_
형식: XAsyncBlock*
수행 중인 비동기 작업을 정의하는 XAsyncBlock입니다. 호출의 상태를 폴링하고 호출 결과를 검색하기 위해 사용할 수 있는 XAsyncBlock입니다. 자세한 내용은 XAsyncBlock을 참조하세요.
반환 값
형식: HRESULT
성공한 경우 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다.
설명
이 API는 패키지 추가 기능 유형이 없는 지속성 콘텐츠을 위한 것입니다. 패키지가 포함된 지속성 콘텐츠는 대신 XStoreAcquireLicenseForPackageAsync를 사용합니다..
이 API는 요청된 지속성 콘텐츠에 대한 라이선스를 획득하려고 합니다. 이 장치가 라이선스를 처음 획득한 경우 서비스 호출이 수행되므로 온라인 연결이 필요합니다. 캐싱으로 인해 동일한 라이선스에 대한 후속 호출이 더 빠를 수 있지만 언제든지 무효화할 수 있습니다. 이 라이선스에 대한 오프라인 액세스는 온라인 상태에서 라이선스를 얻은 후에만 발생할 수 있습니다. PC의 경우 라이선스를 소유하는 계정에 오프라인 권한을 설정해야 합니다.
XStoreRegisterPackageLicenseLost를 사용하여 이 API에서 가져온 라이선스가 손실되었는지를 모니터링할 수 있습니다.
요구 사항
헤더: XStore.h
라이브러리: xgameruntime.lib
지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔