> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XPackageMountWithUiAsync

> XPackageMountWithUiAsync

# 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

```cpp theme={null}
HRESULT XPackageMountWithUiAsync(
  const char * packageIdentifier,
  XAsyncBlock * async
) noexcept;
```

### 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](/pt-BR/reference/system/xpackage/structs/xpackagedetails) retornada de  [XPackageEnumerationCallback](/pt-BR/reference/system/xpackage/functions/xpackageenumerationcallback).
Para obter mais informações sobre identificadores de pacote, consulte [Gerenciar e licenciar conteúdo baixável (DLC)](/pt-BR/publishing/xstore-commerce/xstore-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](/pt-BR/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync) / [Result](/pt-BR/reference/system/xstore/functions/xstoreacquirelicenseforpackageresult) e [XStoreIsLicenseValid](/pt-BR/reference/system/xstore/functions/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.

```cpp theme={null}
extern void RenderDlc(const char* packageId, const char* displayName, bool monochrome); 

void ShowDlc() 
{ 
// Enumerate all DLC for the game and render it to the user 
XPackageEnumeratePackages(XPackageKind::Content, XPackageEnumerationScope::ThisAndRelated, nullptr,
 [](void*, const XPackageDetails* details) 
  {     
        RenderDlc(details->packageIdentifier,
                  details->displayName, 
                  details->ageRestricted);
  }); 
} 

 HRESULT MountDlc(const char* packageId, XPackageMountHandle* handle)
 {  
    XAsync async{};  
    RETURN_IF_FAILED(XPackageMountWithUiAsync(packageId, &async));
    RETURN_IF_FAILED(XAsyncGetStatus(&async, true));
    RETURN_IF_FAILED(XPackageMountWithUiResult(&async, handle));  
    return S_OK; 
} 
```

## 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

* [Suporte a jogos como serviço (GaaS)](/pt-BR/build/core-features/common/packaging/supporting-games-as-a-service)

## Confira também

[XPackageMountWithUiResult](/pt-BR/reference/system/xpackage/functions/xpackagemountwithuiresult)
[XPackage](/pt-BR/reference/system/xpackage/xpackage_members)\
[XPackageEnumeratePackages](/pt-BR/reference/system/xpackage/functions/xpackageenumeratepackages)\
[XPackageEnumerationCallback](/pt-BR/reference/system/xpackage/functions/xpackageenumerationcallback)\
[XPackageDetails](/pt-BR/reference/system/xpackage/structs/xpackagedetails)\
[XPackageGetMountPath](/pt-BR/reference/system/xpackage/functions/xpackagegetmountpath)\
[XPackageGetMountPathSize](/pt-BR/reference/system/xpackage/functions/xpackagegetmountpathsize)\
[Como criar e usar pacotes de conteúdo baixável (DLC) para PC e XBOX One](/pt-BR/build/core-features/common/packaging/packaging-downloadable-content-dlc)


## Related topics

- [XPackageMountWithUiAsync](/reference/system/xpackage/functions/xpackagemountwithuiasync.md)
- [[DEPRECATED] XPackageMount](/reference/system/xpackage/functions/xpackagemount.md)
- [[EN DESUSO] XPackageMount](/es/reference/system/xpackage/functions/xpackagemount.md)