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

# XtfGetOverlayFolder

> XtfGetOverlayFolder

# XtfGetOverlayFolder

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

<a id="syntaxSection" />

## Sintaxe

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

<a id="ID4ET" />

### Parâmetros

*address*<br />Tipo: PCWSTR

\[in] Ponteiro para o endereço do console.

*packageFullName*<br />Tipo: PCWSTR

\[in] Ponteiro para o nome completo do pacote do aplicativo.

*overlayFolderPath*<br />Tipo: PWSTR

\[out, optional] O caminho da pasta de sobreposição.

*overlayFolderPathLength*<br />Tipo: UINT32

\[in, out] Comprimento de overlayFolderPath em WCHAR.

<a id="ID4E1" />

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

<a id="remarks" />

## Comentários

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


## Related topics

- [XtfSetOverlayFolder](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfsetoverlayfolder-xtfapi-xbox-windows-m.md)
- [XtfClearAllOverlayFolders](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfclearalloverlayfolders-xtfapi-xbox-windows-m.md)
- [Gerenciar pacotes (wdapp.exe)](/pt-BR/tools/tools-console/console_commandlinetools/wdapp.md)
- [XBOX Manager: gerenciar apps e arquivos](/pt-BR/tools/tools-console/xbom/manager-tool-managing-applications.md)
- [Gerenciar pastas de sobreposição](/pt-BR/tools/tools-console/devhome/devhome-overlay-folders.md)