> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XStoreAcquireLicenseForPackageResult

> XStoreAcquireLicenseForPackageResult

Retrieves the results of a call to [XStoreAcquireLicenseForPackageAsync](https://docs.xbox.com/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync.md).

## Syntax

```cpp theme={null}
HRESULT XStoreAcquireLicenseForPackageResult(  
         XAsyncBlock* async,  
         XStoreLicenseHandle* storeLicenseHandle  
)  
```

### Parameters

*async*   \_Inout\_\
Type: [XAsyncBlock\*](https://docs.xbox.com/reference/system/xasync/structs/xasyncblock.md)

The XAsyncBlock passed to [XStoreAcquireLicenseForPackageAsync](https://docs.xbox.com/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync.md).
Use the [XAsyncBlock](https://docs.xbox.com/reference/system/xasync/structs/xasyncblock.md) to check the call's status and get the results.
For more information, see [XAsyncBlock](https://docs.xbox.com/reference/system/xasync/structs/xasyncblock.md).

*storeLicenseHandle*   \_Out\_\
Type: XStoreLicenseHandle\*

If the call succeeds, this value is the handle to the store license.

### Return value

Type: HRESULT

Returns **S\_OK** if successful, or an error code otherwise.

`XStoreAcquireLicenseForPackageResult` can return the following error codes:

| Error code | Description |
| - | - |
| 0x87E10BC6 `LM_E_CONTENT_NOT_IN_CATALOG` | The product wasn't found in the catalog. |
| 0x803F8001 `LM_E_CONTENT_NOT_OWNED` | The product isn't owned. |
| 0x803F8008 `LM_E_PREDOWNLOAD_LICENSE_NOT_YET_AVAILABLE` | The product is owned but can't be licensed because it isn't released yet. |
| 0x803F9006 `LM_E_ENTITLED_USER_SIGNED_OUT` | Owner of the product isn't signed in. |
| 0x89245305 `E_GAMESTORE_LICENSE_ACTION_THROTTLED` | The game excessively queried a license for the product and is now throttled. Limit is 30 licensing attempts within 10 minutes for the same product. |

## Remarks

You can safely call this function on a time-sensitive thread.

This result function retrieves the execution results of [XStoreAcquireLicenseForPackageAsync](https://docs.xbox.com/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync.md), and the license that the function requests if the execution is successful.
As such, this function should be called after [XStoreAcquireLicenseForPackageAsync](https://docs.xbox.com/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync.md), usually in the context of a callback function.
If a license is returned, call [XStoreIsLicenseValid](https://docs.xbox.com/reference/system/xstore/functions/xstoreislicensevalid.md) to verify the license is valid.

For a usage example, see [XStoreAcquireLicenseForPackageAsync](https://docs.xbox.com/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync.md).

## Requirements

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

**Library:** xgameruntime.lib

**Supported platforms:** Windows, XBOX One family consoles, and XBOX Series consoles

## Conceptual documentation

* [Granting players access to add-on content](https://docs.xbox.com/publishing/xstore-commerce/xstore-granting-access.md)

## See also

[XStore](https://docs.xbox.com/reference/system/xstore/xstore_members.md)\
[XStoreAcquireLicenseForPackageAsync](https://docs.xbox.com/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync.md)\
[XStoreAcquireLicenseForPackageResult](https://docs.xbox.com/reference/system/xstore/functions/xstoreacquirelicenseforpackageresult.md)\
[XStoreIsLicenseValid](https://docs.xbox.com/reference/system/xstore/functions/xstoreislicensevalid.md)\
[XStoreCloseLicenseHandle](https://docs.xbox.com/reference/system/xstore/functions/xstorecloselicensehandle.md)\
[XStoreRegisterPackageLicenseLost](https://docs.xbox.com/reference/system/xstore/functions/xstoreregisterpackagelicenselost.md)\
[XStoreUnregisterPackageLicenseLost](https://docs.xbox.com/reference/system/xstore/functions/xstoreunregisterpackagelicenselost.md)\
[Manage and license downloadable content (DLC)](https://docs.xbox.com/publishing/xstore-commerce/xstore-dlc.md)


## Related topics

- [XStoreAcquireLicenseForPackageAsync](https://docs.xbox.com/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync.md)
- [XStoreUnregisterPackageLicenseLost](https://docs.xbox.com/reference/system/xstore/functions/xstoreunregisterpackagelicenselost.md)
- [XStoreRegisterPackageLicenseLost](https://docs.xbox.com/reference/system/xstore/functions/xstoreregisterpackagelicenselost.md)
- [XStoreIsLicenseValid](https://docs.xbox.com/reference/system/xstore/functions/xstoreislicensevalid.md)
- [XStoreCloseLicenseHandle](https://docs.xbox.com/reference/system/xstore/functions/xstorecloselicensehandle.md)