XtfGetCachedTitleOSVersions

Article
06/22/2023

Gets the version information of each Game OS cached on the console.

Syntax

HRESULT XtfGetCachedTitleOSVersions(
         PCWSTR address,
         XtfGetCachedTitleOSVersionsCallback clientCallback,
         PVOID context
)

Parameters

address
Type: PCWSTR

[in] The address of the console.

clientCallback
Type: XtfGetCachedTitleOSVersionsCallback

[in] The callback to be invoked for each Game OS in the cache on the console.

context
Type: PVOID

[in, optional] A pointer to a context object, to be passed into the callback.

Return value

Type: HRESULT

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

Remarks

Use this function, along with a XtfGetCachedTitleOSVersionsCallback function, to get the version information of each Game OS cached on the console. The callback function provides a FourPartVersion containing the four-part version number, as well as additional information about that Game OS, for each Game OS in the cache.

You can add a Game OS to the cache on the console by calling the XtfCacheTitleOS function, or remove an existing Game OS from the cache by calling the XtfRemoveTitleOSFromCache or XtfRemoveTitleOSFromCacheByVersion functions. 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)

Share via