Skip to main content

XtfGetOverlayFolder

获取与特定包完整名称关联的 overlay folder 路径。

语法

参数

address
类型:PCWSTR
[in] 指向主机地址的指针。 packageFullName
类型:PCWSTR
[in] 指向应用完整包名的指针。 overlayFolderPath
类型:PWSTR
[out, optional] overlay folder 路径。 overlayFolderPathLength
类型:UINT32
[in, out] overlayFolderPath 的长度(以 WCHAR 为单位)。

返回值

类型:HRESULT 如果尚未为指定的完整包名设置任何路径,则 overlayFolderPath 的返回值为 null,overlayFolderPathLength 为零 (0),并返回 S_OK 成功时返回 S_OK。如果 overlayFolderPath 空间不够,则返回 HRESULT_FROM_WIN32(ERROR_MORE_DATA),并在 overlayFolderPathLength 中返回所需的缓冲区长度。

备注

使用 XTFSetOverlayFolder 来设置或清除 overlay folder。使用 XtfGetOverlayFolder 检索当前为某个包设置的 overlay folder 路径。使用 XtfClearAllOverlayFolders 清除主机上之前设置的所有 overlay folder。使用 IXtfApplicationClient::GetInstalled 枚举当前安装在主机上的所有包。

要求

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

另请参阅

XTF 传输错误 (NDA 主题)
其他 Xtf API
使用 Overlay Folder 调试 (NDA 主题)
命令行工具 xbapp overlayfolder (NDA 主题)
最后修改于 2026年8月24日