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

# XtfSetOverlayFolder

> XtfSetOverlayFolder

# XtfSetOverlayFolder

Define ou redefine o valor da pasta de sobreposição associado a um nome completo de pacote específico.

## Sintaxe

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

### Parâmetros

*address*\
Tipo: PCWSTR

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

*packageFullName*\
Tipo: PCWSTR

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

*overlayFolderPath*\
Tipo: PCWSTR

\[in] Ponteiro para uma cadeia de caracteres que contém o caminho da pasta de sobreposição. Se overlayFolderPath for **null**, packageFullName será ignorado e a pasta de sobreposição será redefinida (equivalente a [xbapp overlayfolder package\_full\_name /r (tópico sob NDA)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbapp.md)).

### Valor retornado

Tipo: HRESULT

Um valor retornado de **S\_OK** indica que a função foi bem-sucedida. Qualquer outro valor indica que ocorreu um erro inesperado.

## Comentários

Use [XTFSetOverlayFolder](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfsetoverlayfolder-xtfapi-xbox-windows-m.md) para definir ou limpar uma pasta de sobreposição. Use [XtfGetOverlayFolder](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgetoverlayfolder-xtfapi-xbox-windows-m.md) para recuperar o caminho da pasta de sobreposição definido atualmente para um pacote. Use [XtfClearAllOverlayFolders](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfclearalloverlayfolders-xtfapi-xbox-windows-m.md) para limpar todas as pastas de sobreposição definidas anteriormente no console. Use [IXtfApplicationClient::GetInstalled](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/getinstalled-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md) para enumerar todos os pacotes instalados atualmente no console.

> [!NOTE]
>
> As pastas de sobreposição definidas usando XtfSetOverlayFolder persistem entre reinicializações do console.

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

**Cabeçalho:** xtfapi.h

**Biblioteca:** XtfApi.lib

**Plataformas com suporte:** Windows (para ferramentas de console XBOX)

## Confira também

[Depuração com pastas de sobreposição (tópico sob NDA)](https://docs.xbox.com/pt-BR/build/console-features/debugging-diagnostics/debugging-with-overlay-folders.md)\
Ferramenta de linha de comando [xbapp overlayfolder (tópico sob NDA)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbapp.md)\
[Erros de transporte do XTF (tópico sob NDA)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xtf-transport-errors.md)


## Related topics

- [APIs adicionais do Xtf (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/atoc-xtfapi.md)
- [XtfGetOverlayFolder](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgetoverlayfolder-xtfapi-xbox-windows-m.md)
- [XtfClearAllOverlayFolders](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfclearalloverlayfolders-xtfapi-xbox-windows-m.md)
- [Gerenciar pacotes (wdapp.exe)](https://docs.xbox.com/pt-BR/tools/tools-console/console_commandlinetools/wdapp.md)
- [XBOX Manager: gerenciar apps e arquivos](https://docs.xbox.com/pt-BR/tools/tools-console/xbom/manager-tool-managing-applications.md)