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