XtfRemoveTitleOSFromCacheByVersion
从主机上的缓存中删除与指定 FourPartVersion 匹配的游戏 OS。
语法
HRESULT XtfRemoveTitleOSFromCacheByVersion(
PCWSTR address,
FourPartVersion version
)
参数
address
类型:PCWSTR
[in] 主机的 IP 地址。
version
类型:FourPartVersion
[in] 要删除的由四部分组成的游戏 OS 版本号。
返回值
类型:HRESULT
如果成功,返回 S_OK
;否则返回 HRESULT 错误代码。
备注
通过从主机上的缓存中删除与指定的 FourPartVersion
匹配的游戏 OS,使用此函数来管理预配的游戏 OS 文件。 可使用 XtfGetCachedTitleOSVersions 函数获取主机上缓存的每个游戏 OS 的 FourPartVersion
,或使用 XtfGetTitleOSFourPartVersion 函数获取当前运行的游戏的游戏 OS 的 FourPartVersion
。 如果尝试删除已标记为回退 OS 的游戏 OS,将出现错误。
如果没有要删除的游戏 OS 的 FourPartVersion,请改为使用 XtfRemoveTitleOSFromCache 函数,通过指定不同的标识符(例如要删除的游戏 OS 的 GameOs.vxd 文件的完整路径和文件名)来删除游戏 OS。
还可调用 XtfCacheTitleOS 函数将游戏 OS 添加到主机上的缓存。 有关管理预配的游戏操作系统文件的详细信息,请参阅应用程序管理 (xbapp.exe)(NDA 主题)要求授权和预配 (xbprovision.exe)(NDA 主题)要求授权。
要求
头文件:xtfapi.h
库:XtfApi.lib
支持平台:Windows(适用于 Xbox 主机工具)