Skip to main content

XPersistentLocalStorageGetPathSize

傳回永續性本機儲存體 (PLS) 路徑的長度 (以字元為單位)。

語法

參數

pathSize   _Out_
類型:size_t*
PLS 路徑的長度 (以字元為單位)。

傳回值

類型:HRESULT 如果成功,則傳回 S_OK;否則傳回錯誤碼。如需錯誤碼的清單,請參閱錯誤碼。

備註

在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊,請參閱時間敏感執行緒。
此函式的傳回值會用於 XPersistentLocalStorageGetPath 函式的 pathSize 參數,以傳回裝置上的遊戲專屬 PLS 路徑。如需 PLS 的詳細資訊,請參閱本機儲存體。 呼叫 XPersistentLocalStorageGetPath 函式時,請為 XPersistentLocalStorageGetPath 的 path 參數配置至少與此函式 pathSize 參數中所傳回之值相同數量的字元;否則會導致錯誤。 下列範例說明如何使用 XPersistentLocalStorageGetPathSize 和 XPersistentLocalStorageGetPath 函式來取得遊戲的 PLS 路徑。

需求

標頭: XPersistentLocalStorage.h 程式庫: xgameruntime.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

概念文件

另請參閱

XPersistentLocalStorageGetPath
XPersistentLocalStorage
如何使用新的 MicrosoftGame.config 檔案
Last modified on October 6, 2026