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.
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:- XStoreAcquireLicenseForPackageAsync
- XStoreAcquireLicenseForPackageResult
- XStoreIsLicenseValid
- XStoreCloseLicenseHandle
- XStoreRegisterPackageLicenseLost
- XStoreUnregisterPackageLicenseLost
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 SeriesDocumentação conceitual
- Operações básicas da loja
- Concedendo aos jogadores acesso a conteúdo complementar
- Habilitar testes de licenciamento
Confira também
XStoreXStoreAcquireLicenseForPackageAsync
XStoreAcquireLicenseForPackageResult
XStoreIsLicenseValid
XStoreCloseLicenseHandle
XStoreRegisterPackageLicenseLost
XStoreUnregisterPackageLicenseLost
XStoreCanAcquireLicenseForPackageAsync
XStoreCanAcquireLicenseForPackageResult
Gerenciar e licenciar conteúdo para download (DLC)
