XtfGetOverlayFolder

获取与某一特定包完整名称关联的覆盖文件夹路径。

语法

HRESULT XtfGetOverlayFolder(
        PCWSTR address,
        PCWSTR packageFullName,
        PWSTR overlayFolderPath,
        UINT32* overlayFolderPathLength
)   

参数

address
类型:PCWSTR

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

packageFullName
类型:PCWSTR

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

overlayFolderPath
类型:PWSTR

[out, optional] 覆盖文件夹路径。

overlayFolderPathLength
类型:UINT32

[in, out] overlayFolderPath 的长度 (WCHAR)。

返回值

类型:HRESULT

如果没有为指定的包完整名称设置路径,则 overlayFolderPath 的返回值为 null,overlayFolderPathLength 为零 (0) 且返回 S_OK

成功时返回 S_OK。 如果 overlayFolderPath 不够大,则返回 HRESULT_FROM_WIN32(ERROR_MORE_DATA) 并在 overlayFolderPathLength 中返回所需的缓冲区长度。

备注

使用 XTFSetOverlayFolder 设置或清除覆盖文件夹。 使用 XtfGetOverlayFolder 检索当前为包设置的覆盖文件夹路径。 使用 XtfClearAllOverlayFolders 清除以前在主机上设置的所有覆盖文件夹。 使用 IXtfApplicationClient::GetInstalled 枚举当前在主机上安装的所有包。

要求

头文件:xtfapi.h

库:XtfApi.lib

支持平台:Windows(适用于 Xbox 主机工具)

另请参阅

XTF 传输错误(NDA 主题)要求授权
其他 Xtf API
使用覆盖文件夹调试(NDA 主题)要求授权
命令行工具 xbapp overlayfolder(NDA 主题)要求授权