Skip to main content

XtfSetOverlayFolder

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

语法

参数

address
类型:PCWSTR
[in] 指向主机地址的指针。 packageFullName
类型:PCWSTR
[in] 指向应用的包完整名称的指针。 overlayFolderPath
类型:PCWSTR
[in] 指向包含覆盖文件夹路径的字符串的指针。如果 overlayFolderPath 为 null,则忽略 packageFullName 并重置覆盖文件夹(等同于 xbapp overlayfolder package_full_name /r (NDA 主题))。

返回值

类型:HRESULT 返回值为 S_OK 表示函数成功。其他任何值都表示发生了意外错误。

备注

使用 XTFSetOverlayFolder 设置或清除覆盖文件夹。使用 XtfGetOverlayFolder 检索当前为某个包设置的覆盖文件夹路径。使用 XtfClearAllOverlayFolders 清除之前在主机上设置的所有覆盖文件夹。使用 IXtfApplicationClient::GetInstalled 枚举当前安装在主机上的所有包。
使用 XtfSetOverlayFolder 设置的覆盖文件夹在主机重启后仍会保留。

C++ 示例

要求

头文件: xtfapi.h 库: XtfApi.lib 支持的平台: Windows(用于 XBOX 主机工具)

另请参阅

使用覆盖文件夹进行调试 (NDA 主题)
命令行工具 xbapp overlayfolder (NDA 主题)
XTF 传输错误 (NDA 主题)
最后修改于 2026年8月24日