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

# XtfClearAllOverlayFolders

> XtfClearAllOverlayFolders

# XtfClearAllOverlayFolders

清除主机上所有已安装/已注册包的 Overlay Folder 路径。

## 语法

```cpp theme={null}
HRESULT XtfClearAllOverlayFolders(
        PCWSTR address
)   
```

### 参数

*address*\
类型：PCWSTR

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

### 返回值

类型：HRESULT

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

## 备注

重置开发工具包上所有 PFN 的当前 overlay folder。这会使人感觉从未为任何 PFN 设置过 overlay folder。

调用 **XtfClearAllOverlayFolders** 的效果与执行命令行 [xbapp overlayfolder /R (NDA 主题)](https://docs.xbox.com/zh-CN/tools/tools-console/commandlinetools/xbapp.md) 相同。

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

## 要求

**头文件：** xtfapi.h

**库：** XtfApi.lib

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

## 另请参阅

[使用 Overlay Folder 调试 (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) [其他 Xtf API](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapi/atoc-xtfapi.md)


## Related topics

- [XtfGetOverlayFolder](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapi/functions/xtfgetoverlayfolder-xtfapi-xbox-windows-m.md)
- [XtfSetOverlayFolder](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapi/functions/xtfsetoverlayfolder-xtfapi-xbox-windows-m.md)
- [其他 Xtf API（API 内容）](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapi/atoc-xtfapi.md)
- [XtfRegisterAllPackagesOnDrive](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapi/functions/xtfregisterallpackagesondrive-xtfapi-xbox-windows-m.md)
- [ClearState](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_clearstate_public.md)