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

# XStoreAcquireLicenseForDurablesAsync

> XStoreAcquireLicenseForDurablesAsync

# XStoreAcquireLicenseForDurablesAsync

Adquire uma licença para um DLC (durável com pacote), um durável sem pacote ou um produto complementar durável.

## Sintaxe

```cpp theme={null}
HRESULT XStoreAcquireLicenseForDurablesAsync(
         const XStoreContextHandle storeContextHandle,
         const char* storeId,
         XAsyncBlock* async
)
```

### Parâmetros

*storeContextHandle*   \_In\_\
Tipo: XStoreContextHandle

O identificador de contexto da loja para o usuário, retornado por [XStoreCreateContext](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstorecreatecontext.md).

*storeId*   \_In\_z\_\
Tipo: char\*

A ID da loja do durável para o qual adquirir uma licença.

*async*   \_Inout\_\
Tipo: XAsyncBlock\*

Um [XAsyncBlock](https://docs.xbox.com/pt-BR/reference/system/xasync/structs/xasyncblock.md) que define o trabalho assíncrono.
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 da chamada.
Para obter mais informações, consulte [XAsyncBlock](https://docs.xbox.com/pt-BR/reference/system/xasync/structs/xasyncblock.md).

### Valor retornado

Tipo: HRESULT

Retorna **S\_OK** em caso de êxito ou um código de erro caso contrário.

## Comentários

Esta API tenta adquirir uma licença para o durável solicitado.
Se for a primeira vez que o dispositivo está adquirindo a licença, uma chamada de serviço é feita, exigindo, portanto, uma conexão online.
Chamadas subsequentes para a mesma licença podem ser mais rápidas devido ao cache, mas a licença pode ser invalidada a qualquer momento.
No console, o acesso offline exige que o 'XBOX Doméstico' esteja habilitado para a conta proprietária, e a licença deve ser obtida primeiro uma vez enquanto estiver online.
No PC, o acesso offline exige que as 'Permissões offline' estejam definidas para a conta proprietária da licença, e a licença deve ser obtida primeiro uma vez enquanto estiver online.

[XStoreRegisterPackageLicenseLost](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoreregisterpackagelicenselost.md) pode ser usado para monitorar se a licença obtida por esta API foi perdida.

## Requisitos

**Cabeçalho:** XStore.h

**Biblioteca:** xgameruntime.lib

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

## Documentação conceitual

* [Operações básicas da loja](https://docs.xbox.com/pt-BR/publishing/xstore-commerce/xstore-basic-operations.md)
* [Como usar um durável sem pacote](https://docs.xbox.com/pt-BR/publishing/xstore-commerce/xstore-dwob.md)
* [Concedendo aos jogadores acesso a conteúdo complementar](https://docs.xbox.com/pt-BR/publishing/xstore-commerce/xstore-granting-access.md)
* [Habilitar testes de licenciamento](https://docs.xbox.com/pt-BR/publishing/xstore-commerce/xstore-licensing-setup.md)

## Confira também

[XStore](https://docs.xbox.com/pt-BR/reference/system/xstore/xstore_members.md)\
[XAsyncBlock](https://docs.xbox.com/pt-BR/reference/system/xasync/structs/xasyncblock.md)\
[XStoreAcquireLicenseForDurablesResult](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoreacquirelicensefordurablesresult.md)\
[Como usar um durável sem pacote](https://docs.xbox.com/pt-BR/publishing/xstore-commerce/xstore-dwob.md)\
[Concedendo aos jogadores acesso a conteúdo complementar](https://docs.xbox.com/pt-BR/publishing/xstore-commerce/xstore-granting-access.md)


## Related topics

- [XStoreAcquireLicenseForDurablesResult](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoreacquirelicensefordurablesresult.md)
- [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)
- [Habilitar testes de licenciamento](https://docs.xbox.com/pt-BR/publishing/xstore-commerce/xstore-licensing-setup.md)
- [XStoreQueryAddOnLicensesAsync](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstorequeryaddonlicensesasync.md)