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

Gets the overlay folder path associated with a specific package full name.

## Syntax

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

### Parameters

*address*\
Type: PCWSTR

\[in] Pointer to the address of the console.

*packageFullName*\
Type: PCWSTR

\[in] Pointer to the package full name of the app.

*overlayFolderPath*\
Type: PWSTR

\[out, optional] The overlay folder path.

*overlayFolderPathLength*\
Type: UINT32

\[in, out] Length of overlayFolderPath in WCHAR.

### Return value

Type: HRESULT

If no path has been set for the specified package full name, then the returned value of overlayFolderPath is **null**, overlayFolderPathLength is zero (0), and **S\_OK** is returned.

Returns **S\_OK** if successful. Returns **HRESULT\_FROM\_WIN32(ERROR\_MORE\_DATA)** if overlayFolderPath is not large enough and the required buffer length will be returned in overlayFolderPathLength.

## Remarks

Use [XTFSetOverlayFolder](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfsetoverlayfolder-xtfapi-xbox-windows-m.md) to set or clear an overlay folder. Use [XtfGetOverlayFolder](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfgetoverlayfolder-xtfapi-xbox-windows-m.md) to retrieve the overlay folder path currently set for a package. Use [XtfClearAllOverlayFolders](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfclearalloverlayfolders-xtfapi-xbox-windows-m.md) to clear all overlay folder that were previously set on the console. Use [IXtfApplicationClient::GetInstalled](https://docs.xbox.com/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/getinstalled-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md) to enumerate all packages currently installed on the console.

## Requirements

**Header:** xtfapi.h

**Library:** XtfApi.lib

**Supported platforms:** Windows (for XBOX console tools)

## See also

[XTF Transport Errors (NDA topic)](https://docs.xbox.com/tools/tools-console/commandlinetools/xtf-transport-errors.md)\
[Additional Xtf APIs](https://docs.xbox.com/reference/tools/xtf/xtfapi/atoc-xtfapi.md)\
[Debugging with Overlay Folders (NDA topic)](https://docs.xbox.com/build/console-features/debugging-diagnostics/debugging-with-overlay-folders.md)\
Command line tool [xbapp overlayfolder (NDA topic)](https://docs.xbox.com/tools/tools-console/commandlinetools/xbapp.md)


## Related topics

- [XtfSetOverlayFolder](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfsetoverlayfolder-xtfapi-xbox-windows-m.md)
- [XtfClearAllOverlayFolders](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfclearalloverlayfolders-xtfapi-xbox-windows-m.md)
- [Additional Xtf APIs (API contents)](https://docs.xbox.com/reference/tools/xtf/xtfapi/atoc-xtfapi.md)
- [Manage overlay folders](https://docs.xbox.com/tools/tools-console/devhome/devhome-overlay-folders.md)
- [Managing overlay folders](https://docs.xbox.com/tools/tools-console/wdp/windows-device-portal-on-xbox-overlay-folders.md)