> ## 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

# XStoreAcquireLicenseForPackageResult

Recupera os resultados de uma chamada para [XStoreAcquireLicenseForPackageAsync](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync.md).

## Sintaxe

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

### Parâmetros

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

O XAsyncBlock passado para [XStoreAcquireLicenseForPackageAsync](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync.md).
Use o [XAsyncBlock](https://docs.xbox.com/pt-BR/reference/system/xasync/structs/xasyncblock.md) para verificar o status da chamada e obter os resultados.
Para obter mais informações, consulte [XAsyncBlock](https://docs.xbox.com/pt-BR/reference/system/xasync/structs/xasyncblock.md).

*storeLicenseHandle*   \_Out\_\
Tipo: XStoreLicenseHandle\*

Se a chamada for bem-sucedida, esse valor será o identificador da licença da loja.

### Valor retornado

Tipo: HRESULT

Retornará **S\_OK** se for bem-sucedido ou um código de erro caso contrário.

`XStoreAcquireLicenseForPackageResult` pode retornar os seguintes códigos de erro:

| Código de erro | Descrição |
| - | - |
| 0x87E10BC6 `LM_E_CONTENT_NOT_IN_CATALOG` | O produto não foi encontrado no catálogo. |
| 0x803F8001 `LM_E_CONTENT_NOT_OWNED` | O produto não é de propriedade do usuário. |
| 0x803F8008 `LM_E_PREDOWNLOAD_LICENSE_NOT_YET_AVAILABLE` | O produto é de propriedade do usuário, mas não pode ser licenciado porque ainda não foi lançado. |
| 0x803F9006 `LM_E_ENTITLED_USER_SIGNED_OUT` | O proprietário do produto não está conectado. |
| 0x89245305 `E_GAMESTORE_LICENSE_ACTION_THROTTLED` | O jogo consultou uma licença para o produto excessivamente e agora está limitado. O limite é de 30 tentativas de licenciamento em 10 minutos para o mesmo produto. |

## Comentários

É seguro chamar esta função em um thread sensível ao tempo.

Esta função de resultado recupera os resultados da execução de [XStoreAcquireLicenseForPackageAsync](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync.md) e a licença solicitada pela função, se a execução for bem-sucedida.
Assim, esta função deve ser chamada depois de [XStoreAcquireLicenseForPackageAsync](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync.md), geralmente no contexto de uma função de retorno de chamada.
Se uma licença for retornada, chame [XStoreIsLicenseValid](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoreislicensevalid.md) para verificar se a licença é válida.

Para obter um exemplo de uso, consulte [XStoreAcquireLicenseForPackageAsync](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync.md).

## Requisitos

**Cabeçalho:** XStore.h (incluído em XGameRuntime.h)

**Biblioteca:** xgameruntime.lib

**Plataformas com suporte:** Windows, consoles da família XBOX One e consoles XBOX Series

## Documentação conceitual

* [Concedendo aos jogadores acesso a conteúdo complementar](https://docs.xbox.com/pt-BR/publishing/xstore-commerce/xstore-granting-access.md)

## Confira também

[XStore](https://docs.xbox.com/pt-BR/reference/system/xstore/xstore_members.md)\
[XStoreAcquireLicenseForPackageAsync](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync.md)\
[XStoreAcquireLicenseForPackageResult](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoreacquirelicenseforpackageresult.md)\
[XStoreIsLicenseValid](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoreislicensevalid.md)\
[XStoreCloseLicenseHandle](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstorecloselicensehandle.md)\
[XStoreRegisterPackageLicenseLost](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoreregisterpackagelicenselost.md)\
[XStoreUnregisterPackageLicenseLost](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoreunregisterpackagelicenselost.md)\
[Gerenciar e licenciar conteúdo para download (DLC)](https://docs.xbox.com/pt-BR/publishing/xstore-commerce/xstore-dlc.md)


## Related topics

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