XtfRemoveTitleOSFromCache
从主机上的缓存删除游戏 OS。
语法
HRESULT XtfRemoveTitleOSFromCache(
PCWSTR address,
PCWSTR osIdentifier
)
参数
address
类型：PCWSTR
[in] 主机的地址。
osIdentifier
类型：PCWSTR
[in]要删除的 OS 的标识符。 此标识符可以是以下值之一：
- MicrosoftGame.config 文件的完整路径和文件名，其中包含要删除的游戏 OS 版本由四部分组成的版本号
- GameOs.xvd 文件的完整路径和文件名
- 包含 MicrosoftGame.config 或 GameOS.vxd 文件的目录的完整路径
- 要删除的游戏 OS 由四部分组成的版本号
有效标识符的示例：
- D:\MyGame
- \MyDevPC\share\MyGame\MicrosoftGame.config
- xd:\Titles\MyGamePFN\GameOs.xvd
- 10.0.18236.1002
返回值
类型：HRESULT
如果成功，返回 S_OK；否则返回 HRESULT 错误代码。
备注
通过从主机上的缓存删除指定的游戏 OS，使用此函数来管理预配的游戏 OS 文件。 如果尝试删除已标记为回退 OS 的游戏 OS，将出现错误。
如果你想要删除的游戏 OS 有 FourPartVersion，请改为使用 XtfRemoveTitleOSFromCacheByVersion 函数删除该游戏 OS 版本。 可使用 XtfGetCachedTitleOSVersions 函数获取主机上缓存的每个游戏 OS 的 FourPartVersion，或使用 XtfGetTitleOSFourPartVersion 函数获取当前运行的游戏的游戏 OS 的 FourPartVersion。
还可调用 XtfCacheTitleOS 函数将游戏 OS 添加到主机上的缓存。 有关管理预配的游戏操作系统文件的详细信息，请参阅应用程序管理 (xbapp.exe)（NDA 主题）要求授权和预配 (xbprovision.exe)（NDA 主题）要求授权。
要求
头文件：xtfapi.h
库：XtfApi.lib
支持平台：Windows（适用于 Xbox 主机工具）