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

# XStoreRegisterGameLicenseChanged

> XStoreRegisterGameLicenseChanged

# XStoreRegisterGameLicenseChanged

Registra um retorno de chamada para o evento de alteração de licença do título.
Isso se aplica apenas a alterações na licença do título em execução, e não a licenças de duráveis (DLC).

## Sintaxe

```cpp theme={null}
HRESULT XStoreRegisterGameLicenseChanged(  
         XStoreContextHandle storeContextHandle,  
         XTaskQueueHandle queue,  
         void* context,  
         XStoreGameLicenseChangedCallback* callback,  
         XTaskQueueRegistrationToken* token  
)  
```

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

*queue*   \_In\_\
Tipo: XTaskQueueHandle

Fila assíncrona para lidar com o trabalho assíncrono.

*context*   \_In\_opt\_\
Tipo: void\*

Contexto definido pelo jogo a ser passado para o retorno de chamada.

*callback*   \_In\_\
Tipo: XStoreGameLicenseChangedCallback\*

O retorno de chamada a ser registrado.

*token*   \_Out\_\
Tipo: [XTaskQueueRegistrationToken\*](https://docs.xbox.com/pt-BR/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken.md)

Em caso de êxito, contém um token usado para identificar o retorno de chamada.

### Valor retornado

Tipo: HRESULT

Código de êxito ou de erro HRESULT.

## Comentários

Esta função registra a função de retorno de chamada definida por [XStoreGameLicenseChangedCallback](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoregamelicensechangedcallback.md).
A função registrada será chamada quando ocorrer o próximo evento de alteração de licença do jogo.
Esse evento ocorre quando uma compra relacionada ao jogo atual é feita neste dispositivo ou quando a licença do jogo é atualizada e o jogo passa de uma licença de avaliação para uma licença completa.
A função registrada não será chamada pelo ato do registro.
Para evitar um vazamento de memória, você deve chamar [XStoreUnregisterGameLicenseChanged](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoreunregistergamelicensechanged.md) quando terminar de usar a função de retorno de chamada.

Confira [XStoreCreateContext](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstorecreatecontext.md) para obter um exemplo de uso.

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

* [Habilitar o teste 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)\
[XStoreGameLicenseChangedCallback](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoregamelicensechangedcallback.md)\
[XStoreUnregisterGameLicenseChanged](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoreunregistergamelicensechanged.md)


## Related topics

- [XStoreGameLicenseChangedCallback](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoregamelicensechangedcallback.md)
- [XStoreUnregisterGameLicenseChanged](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoreunregistergamelicensechanged.md)
- [XStoreCreateContext](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstorecreatecontext.md)
- [Habilitar testes de licenciamento](https://docs.xbox.com/pt-BR/publishing/xstore-commerce/xstore-licensing-setup.md)
- [XTaskQueueRegistrationToken](https://docs.xbox.com/pt-BR/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken.md)