Skip to main content

XStoreCanAcquireLicenseForStoreIdAsync

Recupera uma licença de visualização para conteúdo licenciável, incluindo duráveis com ou sem pacotes e conteúdo em um disco inserido no momento. Esta API permite que o jogo veja se o produto pode ser licenciado, mas sem realmente adquirir a licença.

Sintaxe

Parâmetros

storeContextHandle   _In_
Tipo: XStoreContextHandle
O identificador de contexto da loja para o usuário, retornado por XStoreCreateContext. storeProductId   _In_z_
Tipo: char*
StoreID do produto a ser verificado async   _Inout_
Tipo: XAsyncBlock*
Um XAsyncBlock que define o trabalho assíncrono que está sendo feito. O XAsyncBlock pode ser usado para sondar o status da chamada e recuperar os resultados da chamada. Para obter mais informações, consulte XAsyncBlock.

Valor retornado

Tipo: HRESULT Código de êxito ou de erro HRESULT.

Comentários

XStoreCanAcquireLicenseForStoreIdAsync permite que um jogo determine se o usuário poderia adquirir uma licença para um determinado conteúdo sem realmente adquirir essa licença e consumir o slot de simultaneidade desse usuário. Esta função não precisa ser usada para o jogo em execução no momento, pois ele já tem uma licença, mas pode determinar se o usuário possui outros jogos ou conteúdos do mesmo editor. Por exemplo, um jogo pode usar esta API para determinar se deve recompensar usuários que possuem versões anteriores do jogo (seja digitalmente ou por meio de um disco inserido) ou para oferecer produtos adicionais ao usuário. Para recuperar a licença de visualização e o resultado da execução desta função, chame XStoreCanAcquireLicenseForStoreIdResult depois de chamar esta função. Este snippet de código mostra um exemplo de uso das seguintes APIs:

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
XStoreCanAcquireLicenseForStoreIdResult
Como usar um durável sem pacote
Concedendo aos jogadores acesso a conteúdo complementar
Last modified on October 6, 2026