XtfStartTitleOSByVersion
从主机上的缓存中启动或重启与指定 FourPartVersion 匹配的游戏 OS。
语法
HRESULT XtfStartTitleOSByVersion(
PCWSTR address,
FourPartVersion version
)
参数
address
类型：PCWSTR
[in] 主机的 IP 地址。
version
类型：FourPartVersion
[in] 要启动的游戏 OS 的由四部分构成的版本信息。
返回值
类型：HRESULT
如果成功，返回 S_OK；否则返回 HRESULT 错误代码。
备注
使用此函数从主机上的缓存中启动或重启与指定 FourPartVersion 匹配的游戏 OS。 可使用 XtfGetCachedTitleOSVersions 函数获取主机上缓存的每个游戏 OS 的 FourPartVersion，或使用 XtfGetTitleOSFourPartVersion 函数获取当前运行的游戏的游戏 OS 的 FourPartVersion。
如果没有要启动或重启的游戏 OS 的 FourPartVersion，请改为使用 XtfStartTitleOS 函数，通过指定不同的标识符（例如游戏 OS 的 GameOs.vxd 文件的完整路径和文件名）来启动或重启游戏 OS。 还可使用 XtfStartTitleOSByGameConfig 函数启动或重启在 MicrosoftGame.config 文件的指定内容中标识的游戏 OS。
如果需要，可调用 XtfCacheTitleOS 函数将游戏 OS 添加到主机上的缓存。 有关管理预配的游戏 OS 文件的详细信息，请参阅应用程序管理 (xbapp.exe)(NDA 主题)要求授权 和 预配 (xbprovision.exe)(NDA 主题)要求授权。
要求
头文件：xtfapi.h
库：XtfApi.lib
支持平台：Windows（适用于 Xbox 主机工具）