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 文件
本地存储
最后修改于 2026年8月24日