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

Obtiene la ruta de acceso de la carpeta de superposición asociada a un nombre completo de paquete específico.

<a id="syntaxSection" />

## Sintaxis

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

<a id="ID4ET" />

### Parámetros

*address*<br />Tipo: PCWSTR

\[in] Puntero a la dirección de la consola.

*packageFullName*<br />Tipo: PCWSTR

\[in] Puntero al nombre completo del paquete de la aplicación.

*overlayFolderPath*<br />Tipo: PWSTR

\[out, optional] La ruta de acceso de la carpeta de superposición.

*overlayFolderPathLength*<br />Tipo: UINT32

\[in, out] Longitud de overlayFolderPath en WCHAR.

<a id="ID4E1" />

### Valor devuelto

Tipo: HRESULT

Si no se ha establecido ninguna ruta de acceso para el nombre completo de paquete especificado, el valor devuelto de overlayFolderPath es **null**, overlayFolderPathLength es cero (0) y se devuelve **S\_OK**.

Devuelve **S\_OK** si se ejecuta correctamente. Devuelve **HRESULT\_FROM\_WIN32(ERROR\_MORE\_DATA)** si overlayFolderPath no es lo suficientemente grande, y la longitud de búfer necesaria se devolverá en overlayFolderPathLength.

<a id="remarks" />

## Comentarios

Use [XTFSetOverlayFolder](/reference/tools/xtf/xtfapi/functions/xtfsetoverlayfolder-xtfapi-xbox-windows-m) para establecer o borrar una carpeta de superposición. Use [XtfGetOverlayFolder](/reference/tools/xtf/xtfapi/functions/xtfgetoverlayfolder-xtfapi-xbox-windows-m) para recuperar la ruta de acceso de la carpeta de superposición establecida actualmente para un paquete. Use [XtfClearAllOverlayFolders](/reference/tools/xtf/xtfapi/functions/xtfclearalloverlayfolders-xtfapi-xbox-windows-m) para borrar todas las carpetas de superposición establecidas anteriormente en la consola. Use [IXtfApplicationClient::GetInstalled](/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/getinstalled-ixtfapplicationclient-xtfapplication-xbox-microsoft-m) para enumerar todos los paquetes instalados actualmente en la consola.

## Requisitos

**Encabezado:** xtfapi.h

**Biblioteca:** XtfApi.lib

**Plataformas compatibles:** Windows (para las herramientas de consola XBOX)

## Consulte también

[Errores de transporte de XTF (tema con NDA)](/tools/tools-console/commandlinetools/xtf-transport-errors)<br />[API de Xtf adicionales](/reference/tools/xtf/xtfapi/atoc-xtfapi)<br />[Depuración con carpetas de superposición (tema con NDA)](/build/console-features/debugging-diagnostics/debugging-with-overlay-folders)<br />Herramienta de línea de comandos [xbapp overlayfolder (tema con NDA)](/tools/tools-console/commandlinetools/xbapp)


## Related topics

- [XtfSetOverlayFolder](/es/reference/tools/xtf/xtfapi/functions/xtfsetoverlayfolder-xtfapi-xbox-windows-m.md)
- [XtfClearAllOverlayFolders](/es/reference/tools/xtf/xtfapi/functions/xtfclearalloverlayfolders-xtfapi-xbox-windows-m.md)
- [XGameSaveFilesGetFolderWithUiAsync](/es/reference/system/xgamesavefiles/functions/xgamesavefilesgetfolderwithuiasync.md)
- [XGameSaveFilesGetFolderWithUiResult](/es/reference/system/xgamesavefiles/functions/xgamesavefilesgetfolderwithuiresult.md)
- [Administración de carpetas de superposición](/es/tools/tools-console/wdp/windows-device-portal-on-xbox-overlay-folders.md)