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

设置或重置与特定包完整名称关联的覆盖文件夹值。

## 语法

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

### 参数

*address*\
类型：PCWSTR

\[in] 指向主机地址的指针。

*packageFullName*\
类型：PCWSTR

\[in] 指向应用的包完整名称的指针。

*overlayFolderPath*\
类型：PCWSTR

\[in] 指向包含覆盖文件夹路径的字符串的指针。如果 overlayFolderPath 为 **null**，则忽略 packageFullName 并重置覆盖文件夹（等同于 [xbapp overlayfolder package\_full\_name /r (NDA 主题)](https://docs.xbox.com/zh-CN/tools/tools-console/commandlinetools/xbapp.md)）。

### 返回值

类型：HRESULT

返回值为 **S\_OK** 表示函数成功。其他任何值都表示发生了意外错误。

## 备注

使用 [XTFSetOverlayFolder](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapi/functions/xtfsetoverlayfolder-xtfapi-xbox-windows-m.md) 设置或清除覆盖文件夹。使用 [XtfGetOverlayFolder](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapi/functions/xtfgetoverlayfolder-xtfapi-xbox-windows-m.md) 检索当前为某个包设置的覆盖文件夹路径。使用 [XtfClearAllOverlayFolders](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapi/functions/xtfclearalloverlayfolders-xtfapi-xbox-windows-m.md) 清除之前在主机上设置的所有覆盖文件夹。使用 [IXtfApplicationClient::GetInstalled](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/getinstalled-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md) 枚举当前安装在主机上的所有包。

> [!NOTE]
>
> 使用 XtfSetOverlayFolder 设置的覆盖文件夹在主机重启后仍会保留。

## 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;
}
```

## 要求

**头文件：** xtfapi.h

**库：** XtfApi.lib

**支持的平台：** Windows（用于 XBOX 主机工具）

## 另请参阅

[使用覆盖文件夹进行调试 (NDA 主题)](https://docs.xbox.com/zh-CN/build/console-features/debugging-diagnostics/debugging-with-overlay-folders.md)\
命令行工具 [xbapp overlayfolder (NDA 主题)](https://docs.xbox.com/zh-CN/tools/tools-console/commandlinetools/xbapp.md)\
[XTF 传输错误 (NDA 主题)](https://docs.xbox.com/zh-CN/tools/tools-console/commandlinetools/xtf-transport-errors.md)


## Related topics

- [其他 Xtf API（API 内容）](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapi/atoc-xtfapi.md)
- [XtfGetOverlayFolder](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapi/functions/xtfgetoverlayfolder-xtfapi-xbox-windows-m.md)
- [XtfClearAllOverlayFolders](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapi/functions/xtfclearalloverlayfolders-xtfapi-xbox-windows-m.md)
- [管理叠加文件夹](https://docs.xbox.com/zh-CN/tools/tools-console/wdp/windows-device-portal-on-xbox-overlay-folders.md)
- [XBOX Manager：管理应用与文件](https://docs.xbox.com/zh-CN/tools/tools-console/xbom/manager-tool-managing-applications.md)