> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XtfSetOverlayFolder

> XtfSetOverlayFolder

# XtfSetOverlayFolder

設定或重設與特定套件完整名稱相關聯的覆疊資料夾值。

<a id="syntaxSection" />

## 語法

```cpp theme={null}
HRESULT XtfSetOverlayFolder(
        PCWSTR address,
        PCWSTR packageFullName,
        PCWSTR overlayFolderPath
)   
```

<a id="ID4ET" />

### 參數

*address*<br />類型：PCWSTR

\[in] 指向主機位址的指標。

*packageFullName*<br />類型：PCWSTR

\[in] 指向應用程式套件完整名稱的指標。

*overlayFolderPath*<br />類型：PCWSTR

\[in] 指向包含覆疊資料夾路徑之字串的指標。如果 overlayFolderPath 為 **null**，則會忽略 packageFullName 並重設覆疊資料夾 (相當於 [xbapp overlayfolder package\_full\_name /r (NDA 主題)](/zh-TW/tools/tools-console/commandlinetools/xbapp))。

<a id="ID4E1" />

### 傳回值

類型：HRESULT

傳回值為 **S\_OK** 表示函式成功。任何其他值都表示發生非預期的錯誤。

<a id="remarks" />

## 備註

使用 [XTFSetOverlayFolder](/zh-TW/reference/tools/xtf/xtfapi/functions/xtfsetoverlayfolder-xtfapi-xbox-windows-m) 設定或清除覆疊資料夾。使用 [XtfGetOverlayFolder](/zh-TW/reference/tools/xtf/xtfapi/functions/xtfgetoverlayfolder-xtfapi-xbox-windows-m) 擷取目前為套件設定的覆疊資料夾路徑。使用 [XtfClearAllOverlayFolders](/zh-TW/reference/tools/xtf/xtfapi/functions/xtfclearalloverlayfolders-xtfapi-xbox-windows-m) 清除先前在主機上設定的所有覆疊資料夾。使用 [IXtfApplicationClient::GetInstalled](/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/getinstalled-ixtfapplicationclient-xtfapplication-xbox-microsoft-m) 列舉目前安裝在主機上的所有套件。

<Note>
  使用 XtfSetOverlayFolder 設定的覆疊資料夾在主機重新開機後仍會保留。
</Note>

<a id="ID4E6C" />

## C++ 範例

```cpp theme={null}
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 主題)](/zh-TW/build/console-features/debugging-diagnostics/debugging-with-overlay-folders)<br />命令列工具 [xbapp overlayfolder (NDA 主題)](/zh-TW/tools/tools-console/commandlinetools/xbapp)<br />[XTF 傳輸錯誤 (NDA 主題)](/zh-TW/tools/tools-console/commandlinetools/xtf-transport-errors)


## Related topics

- [XtfGetOverlayFolder](/zh-TW/reference/tools/xtf/xtfapi/functions/xtfgetoverlayfolder-xtfapi-xbox-windows-m.md)
- [XtfClearAllOverlayFolders](/zh-TW/reference/tools/xtf/xtfapi/functions/xtfclearalloverlayfolders-xtfapi-xbox-windows-m.md)
- [管理套件 (wdapp.exe)](/zh-TW/tools/tools-console/console_commandlinetools/wdapp.md)
- [XBOX 遊戲的 Title Performance Overlay](/zh-TW/tools/tools-console/titleperfoverlay/index.md)
- [管理覆疊資料夾](/zh-TW/tools/tools-console/wdp/windows-device-portal-on-xbox-overlay-folders.md)