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

Recupera os resultados de uma chamada para [XStoreAcquireLicenseForPackageAsync](/pt-BR/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync).

## Sintaxe

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

### Parâmetros

*async*   \_Inout\_\
Tipo: [XAsyncBlock\*](/pt-BR/reference/system/xasync/structs/xasyncblock)

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

*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](/pt-BR/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync) 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](/pt-BR/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync), geralmente no contexto de uma função de retorno de chamada.
Se uma licença for retornada, chame [XStoreIsLicenseValid](/pt-BR/reference/system/xstore/functions/xstoreislicensevalid) para verificar se a licença é válida.

Para obter um exemplo de uso, consulte [XStoreAcquireLicenseForPackageAsync](/pt-BR/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync).

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

## Confira também

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


## Related topics

- [XStoreAcquireLicenseForPackageResult](/ja-jp/reference/system/xstore/functions/xstoreacquirelicenseforpackageresult.md)
- [XStoreAcquireLicenseForPackageAsync](/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync.md)