> ## 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.

# XtfGetOverlayFolder

> XtfGetOverlayFolder

# XtfGetOverlayFolder

取得與特定套件完整名稱相關聯的覆疊資料夾路徑。

<a id="syntaxSection" />

## 語法

```cpp theme={null}
HRESULT XtfGetOverlayFolder(
        PCWSTR address,
        PCWSTR packageFullName,
        PWSTR overlayFolderPath,
        UINT32* overlayFolderPathLength
)   
```

<a id="ID4ET" />

### 參數

*address*<br />類型：PCWSTR

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

*packageFullName*<br />類型：PCWSTR

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

*overlayFolderPath*<br />類型：PWSTR

\[out, optional] 覆疊資料夾路徑。

*overlayFolderPathLength*<br />類型：UINT32

\[in, out] overlayFolderPath 的長度 (以 WCHAR 為單位)。

<a id="ID4E1" />

### 傳回值

類型：HRESULT

如果未針對指定的套件完整名稱設定任何路徑，則 overlayFolderPath 的傳回值為 **null**、overlayFolderPathLength 為零 (0)，並傳回 **S\_OK**。

如果成功，則傳回 **S\_OK**。如果 overlayFolderPath 不夠大，則傳回 **HRESULT\_FROM\_WIN32(ERROR\_MORE\_DATA)**，且所需的緩衝區長度會在 overlayFolderPathLength 中傳回。

<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) 列舉目前安裝在主機上的所有套件。

## 需求

**標頭：** xtfapi.h

**程式庫：** XtfApi.lib

**支援的平台：** Windows (適用於 XBOX 主機工具)

## 另請參閱

[XTF 傳輸錯誤 (NDA 主題)](/zh-TW/tools/tools-console/commandlinetools/xtf-transport-errors)<br />[其他 Xtf API](/zh-TW/reference/tools/xtf/xtfapi/atoc-xtfapi)<br />[使用覆疊資料夾進行偵錯 (NDA 主題)](/zh-TW/build/console-features/debugging-diagnostics/debugging-with-overlay-folders)<br />命令列工具 [xbapp overlayfolder (NDA 主題)](/zh-TW/tools/tools-console/commandlinetools/xbapp)


## Related topics

- [XtfSetOverlayFolder](/zh-TW/reference/tools/xtf/xtfapi/functions/xtfsetoverlayfolder-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)
- [PFGameSaveFilesGetFolder](/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesgetfolder.md)