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

# XtfSetOverlayFolder

> XtfSetOverlayFolder

# XtfSetOverlayFolder

Establece, o restablece, el valor de la carpeta de superposición asociada a un nombre completo de paquete específico.

<a id="syntaxSection" />

## Sintaxis

```cpp theme={null}
HRESULT XtfSetOverlayFolder(
        PCWSTR address,
        PCWSTR packageFullName,
        PCWSTR overlayFolderPath
)   
```

<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: PCWSTR

\[in] Puntero a una cadena que contiene la ruta de acceso de la carpeta de superposición. Si overlayFolderPath es **null**, packageFullName se ignora y la carpeta de superposición se restablece (equivalente a [xbapp overlayfolder package\_full\_name /r (tema con NDA)](/tools/tools-console/commandlinetools/xbapp)).

<a id="ID4E1" />

### Valor devuelto

Tipo: HRESULT

Un valor devuelto de **S\_OK** indica que la función se ejecutó correctamente. Cualquier otro valor indica que se produjo un error inesperado.

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

<Note>
  Las carpetas de superposición establecidas con XtfSetOverlayFolder son persistentes entre reinicios de la consola.
</Note>

<a id="ID4E6C" />

## Ejemplo de C++

```cpp theme={null}
int wmain(int argc, wchar_t **argv)
{
    HRESULT             hr = S_OK;
    PCWSTR              consoleAddress = L"190.167.10.18";
    PCWSTR              pOverlayFolderPFN = L"682716bc-bcec-4d5b-a21d-e2b6a4e3066d_1.0.0.0_x64__8wekyb3d8bbwe";
    PWSTR               pOverlayFolderPath = L"D:\\MyGame1\\";
    PWSTR               pOverlayFolderPathReturned = nullptr;
    UINT32              bufferSize = 0;

    hr = XtfSetOverlayFolder(consoleAddress, pOverlayFolderPFN, pOverlayFolderPath);
    if (FAILED(hr))
    {
        wprintf(L"\n\n*** XtfSetOverlayFolder failed 0x%x", hr);
        return hr;
    }

    pOverlayFolderPathReturned = new WCHAR[APPLICATION_USER_MODEL_ID_MAX_LENGTH];
    hr = XtfGetOverlayFolder(consoleAddress, pOverlayFolderPFN, pOverlayFolderPathReturned, &buffersize);
    if (FAILED(hr))
    {
        wprintf(L"\n\n*** Overlay Folder Path is set to %s", pOverlayFolderPathReturned);
    }
    else
    {
        wprintf(L"\n\n*** XtfGetOverlayFolder failed 0x%x", hr);
    }
    delete[] pOverlayFolderPathReturned;

    return hr;
}
```

## Requisitos

**Encabezado:** xtfapi.h

**Biblioteca:** XtfApi.lib

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

## Consulte también

[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)<br />[Errores de transporte de XTF (tema con NDA)](/tools/tools-console/commandlinetools/xtf-transport-errors)


## Related topics

- [XtfGetOverlayFolder](/es/reference/tools/xtf/xtfapi/functions/xtfgetoverlayfolder-xtfapi-xbox-windows-m.md)
- [XtfClearAllOverlayFolders](/es/reference/tools/xtf/xtfapi/functions/xtfclearalloverlayfolders-xtfapi-xbox-windows-m.md)
- [Administración de carpetas de superposición](/es/tools/tools-console/wdp/windows-device-portal-on-xbox-overlay-folders.md)
- [IXtfApplicationClient::SetDefaultApp](/es/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/setdefaultapp-ixtfapplicationclient-xtfapplication-xbox-wi.md)
- [IXtfFileIOClient::SetFileAttributes (método)](/es/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/setfileattributes-ixtffileioclient-xtffileio-xbox-microsoft-m.md)