Skip to main content

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

Parâmetros

storeContextHandle   _In_
Tipo: XStoreContextHandle
O identificador de contexto da loja para o usuário retornado por XStoreCreateContext. 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*
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. 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 quando terminar de usar a função de retorno de chamada. Confira XStoreCreateContext 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

Confira também

XStore
XStoreGameLicenseChangedCallback
XStoreUnregisterGameLicenseChanged
Last modified on October 6, 2026