通过

XtfSetOverlayFolder

  • 项目

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

语法

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 主题)）。

返回值

类型：HRESULT

返回值 S_OK 指示函数成功。 任何其他值指示出现意外错误。

备注

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

注意

使用 XtfSetOverlayFolder 设置的覆盖文件夹在主机重新启动后仍保留。

C++ 示例

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 主题）
命令行工具 xbapp overlayfolder（NDA 主题）
XTF 传输错误 (NDA 主题)