Skip to main content

XPackageMountWithUiAsync

Monta de forma assíncrona a instalação do conteúdo especificado e retorna um identificador de montagem para ela. Mostra a interface do usuário de consentimento dos pais se o conteúdo tiver restrição de idade com base nas configurações de controle dos pais de todos os usuários conectados.

Sintaxe

Parâmetros

packageIdentifier  _In_z_
Tipo: const char *
Uma cadeia de caracteres que identifica exclusivamente o pacote instalado no disco. Passe o campo packageIdentifier da estrutura XPackageDetails retornada de XPackageEnumerationCallback. Para obter mais informações sobre identificadores de pacote, consulte Gerenciar e licenciar conteúdo baixável (DLC). async  _Inout_
Tipo: XAsyncBlock *
Um XAsyncBlock para monitorar o status da chamada assíncrona.

Valor retornado

Tipo: HRESULT Código de sucesso ou de erro HRESULT.

Comentários

Esta API mostra um prompt de consentimento dos pais ao usuário se a API montar conteúdo que não seja apropriado para a idade de todos os usuários conectados. Se um usuário adulto aprovar o consentimento dos pais no prompt, a API tentará montar o pacote. Se um usuário adulto negar o consentimento dos pais no prompt, a API não conseguirá montar o pacote. Esta API chama automaticamente XStoreAcquireLicenseForPackageAsync / Result e XStoreIsLicenseValid. Se a API não conseguir adquirir uma licença válida para o DLC, a montagem falhará. Neste exemplo de código, um jogo renderiza o DLC em preto e branco se o conteúdo tiver restrição de idade. O código externo no jogo chama MountDlc quando o usuário seleciona um item de DLC para usar.

Requisitos

Cabeçalho: XPackage.h Biblioteca: xgameruntime.lib Plataformas compatíveis: Windows, consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Confira também

XPackageMountWithUiResult XPackage
XPackageEnumeratePackages
XPackageEnumerationCallback
XPackageDetails
XPackageGetMountPath
XPackageGetMountPathSize
Como criar e usar pacotes de conteúdo baixável (DLC) para PC e XBOX One
Last modified on October 6, 2026