XStoreAcquireLicenseForPackageResult

Retrieves the results of a call to XStoreAcquireLicenseForPackageAsync.

Syntax

HRESULT XStoreAcquireLicenseForPackageResult(  
         XAsyncBlock* async,  
         XStoreLicenseHandle* storeLicenseHandle  
)  

Parameters

async   _Inout_
Type: XAsyncBlock*

The XAsyncBlock passed to XStoreAcquireLicenseForPackageAsync. The XAsyncBlock can be used to poll for the call's status and retrieve call results. See XAsyncBlock for more information.

storeLicenseHandle   _Out_
Type: XStoreLicenseHandle*

On success contains the handle to the store license.

Return value

Type: HRESULT

Returns S_OK upon success, or an error code otherwise.

XStoreAcquireLicenseForPackageResult can return the following error codes:

Error code Description
0x87E10BC6 LM_E_CONTENT_NOT_IN_CATALOG The product was not found in the catalog.
0x803F8001 LM_E_CONTENT_NOT_OWNED The product is not owned.
0x803F8008 LM_E_PREDOWNLOAD_LICENSE_NOT_YET_AVAILABLE The product is owned but cannot be licensed because it has not been released yet.
0x803F9006 LM_E_ENTITLED_USER_SIGNED_OUT Owner of the product is not signed in.
0x89245305 E_GAMESTORE_LICENSE_ACTION_THROTTLED The game has excessively requested a license for the product and is now being throttled.

Remarks

This function is safe to call on a time-sensitive thread.

This result function allows you to retrieve the execution results of XStoreAcquireLicenseForPackageAsync, as well as the license that was called for if the execution was successful. As such, this function should be called after XStoreAcquireLicenseForPackageAsync has been called, usually in the context of a callback function. See XStoreAcquireLicenseForPackageAsync for a usage example.

Requirements

Header: XStore.h (included in XGameRuntime.h)

Library: xgameruntime.lib

Supported platforms: Windows, Xbox One family consoles and Xbox Series consoles

See also

XStore
XStoreAcquireLicenseForPackageAsync
XStoreAcquireLicenseForPackageResult
XStoreIsLicenseValid
XStoreCloseLicenseHandle
XStoreRegisterPackageLicenseLost
XStoreUnregisterPackageLicenseLost