Skip to main content

XStoreAcquireLicenseForPackageAsync

Adquire uma licença para um pacote de DLC instalado (tipo de produto durável com pacote) para o jogo atual que o usuário tem direito de usar. XStoreRegisterPackageLicenseLost pode ser usado para monitorar se a licença obtida por esta API foi perdida.
Esta API não funciona com complementos duráveis sem pacote.
Para obter a licença de um durável sem pacote, use XStoreAcquireLicenseForDurablesAsync.

Sintaxe

Parâmetros

storeContextHandle   _In_
Tipo: XStoreContextHandle
O identificador de contexto da loja para o usuário, retornado por XStoreCreateContext. packageIdentifier   _In_z_
Tipo: char*
Uma cadeia de caracteres que identifica exclusivamente um pacote da loja. O identificador do pacote normalmente é retornado como parte de uma operação XPackageEnumeratePackages. Para obter mais informações sobre identificadores de pacote, consulte Gerenciar e licenciar conteúdo para download (DLC). 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

Para recuperar a licença do pacote e o resultado da execução desta função, chame XStoreAcquireLicenseForPackageResult depois de chamar esta função. Se quiser verificar se um pacote pode ser licenciado, chame XStoreCanAcquireLicenseForPackageAsync. Depois de adquirir uma licença, você deve verificar se ela é válida chamando XStoreIsLicenseValid. XPackageMountWithUiAsync adquirirá automaticamente uma licença quando for chamada. Se não for possível adquirir uma licença, a montagem do pacote falhará. 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
XStoreAcquireLicenseForPackageAsync
XStoreAcquireLicenseForPackageResult
XStoreIsLicenseValid
XStoreCloseLicenseHandle
XStoreRegisterPackageLicenseLost
XStoreUnregisterPackageLicenseLost
XStoreCanAcquireLicenseForPackageAsync
XStoreCanAcquireLicenseForPackageResult
Gerenciar e licenciar conteúdo para download (DLC)
Last modified on October 6, 2026