Pular para o conteúdo principal

XtfGetOverlayFolder

Obtém o caminho 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: PWSTR
[out, optional] O caminho da pasta de sobreposição. overlayFolderPathLength
Tipo: UINT32
[in, out] Comprimento de overlayFolderPath em WCHAR.

Valor retornado

Tipo: HRESULT Se nenhum caminho tiver sido definido para o nome completo do pacote especificado, o valor retornado de overlayFolderPath será null, overlayFolderPathLength será zero (0) e S_OK será retornado. Retorna S_OK se for bem-sucedido. Retorna HRESULT_FROM_WIN32(ERROR_MORE_DATA) se overlayFolderPath não for grande o suficiente, e o comprimento de buffer necessário será retornado em overlayFolderPathLength.

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.

Requisitos

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

Confira também

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