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

# XtfGetOverlayFolder

> XtfGetOverlayFolder

# XtfGetOverlayFolder

Obtém o caminho da pasta de sobreposição associado a um nome completo de pacote específico.

## Sintaxe

```cpp theme={null}
HRESULT XtfGetOverlayFolder(
        PCWSTR address,
        PCWSTR packageFullName,
        PWSTR overlayFolderPath,
        UINT32* overlayFolderPathLength
)   
```

### 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](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfsetoverlayfolder-xtfapi-xbox-windows-m.md) para definir ou limpar uma pasta de sobreposição. Use [XtfGetOverlayFolder](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgetoverlayfolder-xtfapi-xbox-windows-m.md) para recuperar o caminho da pasta de sobreposição definido atualmente para um pacote. Use [XtfClearAllOverlayFolders](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfclearalloverlayfolders-xtfapi-xbox-windows-m.md) para limpar todas as pastas de sobreposição definidas anteriormente no console. Use [IXtfApplicationClient::GetInstalled](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/getinstalled-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md) 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)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xtf-transport-errors.md)\
[APIs adicionais do Xtf](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/atoc-xtfapi.md)\
[Depuração com pastas de sobreposição (tópico sob NDA)](https://docs.xbox.com/pt-BR/build/console-features/debugging-diagnostics/debugging-with-overlay-folders.md)\
Ferramenta de linha de comando [xbapp overlayfolder (tópico sob NDA)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbapp.md)


## Related topics

- [XtfSetOverlayFolder](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfsetoverlayfolder-xtfapi-xbox-windows-m.md)
- [XtfClearAllOverlayFolders](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfclearalloverlayfolders-xtfapi-xbox-windows-m.md)
- [APIs adicionais do Xtf (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/atoc-xtfapi.md)
- [Gerenciar pacotes (wdapp.exe)](https://docs.xbox.com/pt-BR/tools/tools-console/console_commandlinetools/wdapp.md)
- [XBOX Manager: gerenciar apps e arquivos](https://docs.xbox.com/pt-BR/tools/tools-console/xbom/manager-tool-managing-applications.md)