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

Obtient le chemin du dossier de superposition associé à un nom complet de package spécifique.

<a id="syntaxSection" />

## Syntaxe

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

<a id="ID4ET" />

### Paramètres

*address*<br />Type : PCWSTR

\[in] Pointeur vers l'adresse de la console.

*packageFullName*<br />Type : PCWSTR

\[in] Pointeur vers le nom complet du package de l'application.

*overlayFolderPath*<br />Type : PWSTR

\[out, optional] Chemin du dossier de superposition.

*overlayFolderPathLength*<br />Type : UINT32

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

<a id="ID4E1" />

### Valeur de retour

Type : HRESULT

Si aucun chemin n'a été défini pour le nom complet de package spécifié, la valeur retournée de overlayFolderPath est **null**, overlayFolderPathLength vaut zéro (0) et **S\_OK** est retourné.

Retourne **S\_OK** en cas de réussite. Retourne **HRESULT\_FROM\_WIN32(ERROR\_MORE\_DATA)** si overlayFolderPath n'est pas assez grand ; la longueur de mémoire tampon requise est alors retournée dans overlayFolderPathLength.

<a id="remarks" />

## Remarques

Utilisez [XTFSetOverlayFolder](/fr/reference/tools/xtf/xtfapi/functions/xtfsetoverlayfolder-xtfapi-xbox-windows-m) pour définir ou effacer un dossier de superposition. Utilisez [XtfGetOverlayFolder](/fr/reference/tools/xtf/xtfapi/functions/xtfgetoverlayfolder-xtfapi-xbox-windows-m) pour récupérer le chemin du dossier de superposition actuellement défini pour un package. Utilisez [XtfClearAllOverlayFolders](/fr/reference/tools/xtf/xtfapi/functions/xtfclearalloverlayfolders-xtfapi-xbox-windows-m) pour effacer tous les dossiers de superposition précédemment définis sur la console. Utilisez [IXtfApplicationClient::GetInstalled](/fr/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/getinstalled-ixtfapplicationclient-xtfapplication-xbox-microsoft-m) pour énumérer tous les packages actuellement installés sur la console.

## Configuration requise

**En-tête :** xtfapi.h

**Bibliothèque :** XtfApi.lib

**Plateformes prises en charge :** Windows (pour les outils de console XBOX)

## Voir aussi

[Erreurs de transport XTF (rubrique NDA)](/fr/tools/tools-console/commandlinetools/xtf-transport-errors)<br />[API Xtf supplémentaires](/fr/reference/tools/xtf/xtfapi/atoc-xtfapi)<br />[Débogage avec des dossiers de superposition (rubrique NDA)](/fr/build/console-features/debugging-diagnostics/debugging-with-overlay-folders)<br />Outil en ligne de commande [xbapp overlayfolder (rubrique NDA)](/fr/tools/tools-console/commandlinetools/xbapp)


## Related topics

- [XtfGetOverlayFolder](/reference/tools/xtf/xtfapi/functions/xtfgetoverlayfolder-xtfapi-xbox-windows-m.md)
- [XtfSetOverlayFolder](/reference/tools/xtf/xtfapi/functions/xtfsetoverlayfolder-xtfapi-xbox-windows-m.md)
- [XtfClearAllOverlayFolders](/reference/tools/xtf/xtfapi/functions/xtfclearalloverlayfolders-xtfapi-xbox-windows-m.md)