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