Skip to main content

XStoreQueryAddOnLicensesAsync

Enumera as licenças de todos os complementos duráveis que estão anexados a uma licença de jogo digital. Isso se aplica somente a duráveis sem tipos de pacote e só pode ser usado com uma licença digital, não com licenças de disco. Executar isso com uma licença de disco resultará em resultados vazios, mesmo que existam duráveis individuais que o usuário possua ou possa licenciar. Para cenários de disco, use XStoreAcquireLicenseForDurablesAsync em vez disso.

Sintaxe

Parâmetros

storeContextHandle   _In_
Tipo: XStoreContextHandle
O identificador de contexto da loja do usuário retornado por XStoreCreateContext. 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. Consulte XAsyncBlock para obter mais informações.

Valor retornado

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

Comentários

Para recuperar a licença do complemento, bem como o resultado da execução desta função, chame XStoreQueryAddonLicensesResult após chamar esta função. Para recuperar o número de licenças obtidas por esta função, chame XStoreQueryAddonLicensesResultCount após chamar esta função. A função de contagem de resultados é importante, pois permitirá que você determine o tamanho apropriado da matriz a ser passada para a função de resultado. O snippet de código a seguir mostra um exemplo de recuperação de licenças de complementos duráveis (sem pacote) que o usuário possui ou pode licenciar:

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
XStoreQueryAddonLicensesResult
XStoreQueryAddonLicensesResultCount
Last modified on October 6, 2026