Skip to main content

XPersistentLocalStorageMountForPackage

將指定套件的永續性本機儲存體 (PLS) 掛接為唯讀磁碟。

語法

參數

packageIdentifier   _In_
類型:char*
唯一識別 PLS 所屬之市集套件的字串。如需套件識別碼的詳細資訊,請參閱管理可下載內容 (DLC) 及其授權。 mountHandle   _Out_writes_to_(pathSize,pathUsed)
類型:XPackageMountHandle
已掛接 PLS 之磁碟的掛接控制代碼。

傳回值

類型:HRESULT 如果成功,則傳回 S_OK;否則傳回錯誤碼。如需錯誤碼的清單,請參閱錯誤碼。如果函式因指定遊戲的 PLS 不存在而失敗,則會設為 FILE_NOT_FOUND。如果函式因嘗試存取未啟用可共用永續性本機儲存體之遊戲的 PLS 而失敗,則會得到 ACCESS_DENIED。

備註

在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊,請參閱時間敏感執行緒。
若要讓遊戲支援可共用的 PLS,必須在 MicrosoftGame.config 中如此宣告。如需可共用永續性本機儲存體的詳細資訊,請參閱本機儲存體
如果遊戲將 PLS 標示為可共用,則應確保在暫停遊戲之前,關閉其 PLS 的所有控制代碼,否則遊戲暫停將會失敗,而遊戲將會終止。
下列程式碼片段示範存取另一個遊戲之可共用 PLS 的範例。

需求

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

概念文件

另請參閱

XPersistentLocalStorage
如何使用新的 MicrosoftGame.config 檔案
本機儲存體
Last modified on October 6, 2026