XtfGetTitleOSFourPartVersion

Gets version information about the Game OS for the currently running title.

Syntax

HRESULT XtfGetTitleOSFourPartVersion(
         PCWSTR address,
         UINT32* flags,
         FourPartVersion* version
)

Parameters

address
Type: PCWSTR

[in] The address of the console.

flags
Type: UINT32*

[out] A bitwise-OR combination of flags that provide additional information about the Game OS. This parameter supports the following flags:

Flag Value Description
XTF_CACHED_TITLE_OS_IS_FALLBACK 0x0001 Indicates that this Game OS is the fallback OS, which cannot be deleted or replaced.

version
Type: FourPartVersion*

[out] The four-part version number of the Game OS.

Return value

Type: HRESULT

Returns S_OK if successful; otherwise, returns an HRESULT error code.

Remarks

Use this function to return version information about the Game OS for the currently running title. If there is no Game OS currently running, an error occurs. You can also use the XtfGetCachedTitleOSVersions function to return version information about other Game OS versions cached on the console. For more information about managing provisioned Game OS files, see Application Management (xbapp.exe) (NDA topic)Authorization required and Provision (xbprovision.exe) (NDA topic)Authorization required.

Requirements

Header: xtfapi.h

Library: XtfApi.lib

Supported platforms: Windows (for Xbox console tools)

See also

Run from PC Deployment (NDA topic)Authorization required
XtfGetPackageFullName
XtfGetAumid
XTF Transport Errors (NDA topic)Authorization required
Additional Xtf APIs