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

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

<a id="syntaxSection" />

## Sintaxe

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

<a id="parametersSection" />

### Parâmetros

*storeContextHandle*   \_In\_\
Tipo: XStoreContextHandle

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

*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](/pt-BR/reference/system/xasync/structs/xasyncblock) que define o trabalho assíncrono.
Use o [XAsyncBlock](/pt-BR/reference/system/xasync/structs/xasyncblock) para verificar o status da chamada e obter os resultados da chamada.
Para obter mais informações, consulte [XAsyncBlock](/pt-BR/reference/system/xasync/structs/xasyncblock).

<a id="retvalSection" />

### Valor retornado

Tipo: HRESULT

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

<a id="remarksSection" />

## 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](/pt-BR/reference/system/xstore/functions/xstoreregisterpackagelicenselost) pode ser usado para monitorar se a licença obtida por esta API foi perdida.

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** XStore.h

**Biblioteca:** xgameruntime.lib

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

<a id="seealsoSection" />

## Documentação conceitual

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

## Confira também

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


## Related topics

- [XStoreAcquireLicenseForDurablesAsync](/reference/system/xstore/functions/xstoreacquirelicensefordurablesasync.md)
- [XStoreAcquireLicenseForDurablesResult](/reference/system/xstore/functions/xstoreacquirelicensefordurablesresult.md)
- [XStoreAcquireLicenseForPackageAsync](/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync.md)
- [XStoreRegisterPackageLicenseLost](/reference/system/xstore/functions/xstoreregisterpackagelicenselost.md)
- [XStoreQueryAddOnLicensesAsync](/reference/system/xstore/functions/xstorequeryaddonlicensesasync.md)