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

# XStoreAcquireLicenseForPackageResult

> XStoreAcquireLicenseForPackageResult

# XStoreAcquireLicenseForPackageResult

Retrieves the results of a call to [XStoreAcquireLicenseForPackageAsync](/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync).

## Syntax

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

### Parameters

*async*   \_Inout\_\
Type: [XAsyncBlock\*](/reference/system/xasync/structs/xasyncblock)

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

*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](/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync), and the license that the function requests if the execution is successful.
As such, this function should be called after [XStoreAcquireLicenseForPackageAsync](/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync), usually in the context of a callback function.
If a license is returned, call [XStoreIsLicenseValid](/reference/system/xstore/functions/xstoreislicensevalid) to verify the license is valid.

For a usage example, see [XStoreAcquireLicenseForPackageAsync](/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync).

## 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](/publishing/xstore-commerce/xstore-granting-access)

## See also

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