跳轉到主要內容

XtfGetOverlayFolder

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

語法

參數

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 主題)
最後修改於 2026年10月6日