다음을 통해 공유


XStoreAcquireLicenseForPackageResult

XStoreAcquireLicenseForPackageAsync에 대한 호출 결과를 검색합니다.

구문

HRESULT XStoreAcquireLicenseForPackageResult(  
         XAsyncBlock* async,  
         XStoreLicenseHandle* storeLicenseHandle  
)  

매개 변수

async _Inout_
형식: XAsyncBlock*

XStoreAcquireLicenseForPackageAsync에 전달된 XAsyncBlock입니다. 호출의 상태를 폴링하고 호출 결과를 검색하기 위해 사용할 수 있는 XAsyncBlock입니다. 자세한 내용은 XAsyncBlock을 참조하세요.

storeLicenseHandle _Out_
형식: XStoreLicenseHandle*

성공 시, Microsoft Store 라이선스에 대한 핸들을 포함합니다.

반환 값

형식: HRESULT

성공한 경우 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다.

XStoreAcquireLicenseForPackageResult은(는) 다음 오류 코드를 반환할 수 있습니다.

오류 코드 설명
0x87E10BC6 LM_E_CONTENT_NOT_IN_CATALOG 카탈로그에서 제품을 찾을 수 없습니다.
0x803F8001 LM_E_CONTENT_NOT_OWNED 제품은 소유되지 않습니다.
0x803F8008 LM_E_PREDOWNLOAD_LICENSE_NOT_YET_AVAILABLE 이 제품은 소유되지만 아직 릴리스되지 않았기 때문에 라이선스를 받을 수 없습니다.
0x803F9006 LM_E_ENTITLED_USER_SIGNED_OUT 제품 소유자가 로그인되어 있지 않습니다.
0x89245305 E_GAMESTORE_LICENSE_ACTION_THROTTLED 게임이 제품에 대한 라이선스를 과도하게 요청했으며 현재 제한되고 있습니다.

비고

이 함수는 시간에 민감한 스레드에서 호출하는 것이 안전합니다.

이 결과 함수를 사용하면 XStoreAcquireLicenseForPackageAsync의 실행 결과를, 그리고 실행에 성공했다면 호출한 라이선스까지 검색할 수 있습니다. 따라서 이 함수는 (대부분의 경우 콜백 함수의 컨텍스트에서) XStoreAcquireLicenseForPackageAsync가 호출된 후에 호출해야 합니다. 사용 예는 XStoreAcquireLicenseForPackageAsync를 참조하세요.

요구 사항

헤더: XStore.h(XGameRuntime.h에 포함됨)

라이브러리: xgameruntime.lib

지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

XStore
XStoreAcquireLicenseForPackageAsync
XStoreAcquireLicenseForPackageResult
XStoreIsLicenseValid
XStoreCloseLicenseHandle
XStoreRegisterPackageLicenseLost
XStoreUnregisterPackageLicenseLost