Pular para o conteúdo principal

XtfSetOverlayFolder

Define ou redefine o valor da pasta de sobreposição associado a um nome completo de pacote específico.

Sintaxe

Parâmetros

address
Tipo: PCWSTR
[in] Ponteiro para o endereço do console. packageFullName
Tipo: PCWSTR
[in] Ponteiro para o nome completo do pacote do aplicativo. overlayFolderPath
Tipo: PCWSTR
[in] Ponteiro para uma cadeia de caracteres que contém o caminho da pasta de sobreposição. Se overlayFolderPath for null, packageFullName será ignorado e a pasta de sobreposição será redefinida (equivalente a xbapp overlayfolder package_full_name /r (tópico sob NDA)).

Valor retornado

Tipo: HRESULT Um valor retornado de S_OK indica que a função foi bem-sucedida. Qualquer outro valor indica que ocorreu um erro inesperado.

Comentários

Use XTFSetOverlayFolder para definir ou limpar uma pasta de sobreposição. Use XtfGetOverlayFolder para recuperar o caminho da pasta de sobreposição definido atualmente para um pacote. Use XtfClearAllOverlayFolders para limpar todas as pastas de sobreposição definidas anteriormente no console. Use IXtfApplicationClient::GetInstalled para enumerar todos os pacotes instalados atualmente no console.
As pastas de sobreposição definidas usando XtfSetOverlayFolder persistem entre reinicializações do console.

Exemplo em C++

Requisitos

Cabeçalho: xtfapi.h Biblioteca: XtfApi.lib Plataformas com suporte: Windows (para ferramentas de console XBOX)

Confira também

Depuração com pastas de sobreposição (tópico sob NDA)
Ferramenta de linha de comando xbapp overlayfolder (tópico sob NDA)
Erros de transporte do XTF (tópico sob NDA)
Última modificação em 6 de outubro de 2026