> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XtfGetCachedTitleOSVersions

> XtfGetCachedTitleOSVersions

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

## Syntax

```cpp theme={null}
HRESULT XtfGetCachedTitleOSVersions(
         PCWSTR address,
         XtfGetCachedTitleOSVersionsCallback clientCallback,
         PVOID context
)  
```

### Parameters

*address*\
Type: PCWSTR

\[in] The address of the console.

*clientCallback*\
Type: [XtfGetCachedTitleOSVersionsCallback](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversionscallback-xtfapi-xbox-windows-m.md)

\[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](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversionscallback-xtfapi-xbox-windows-m.md) function, to get the version information of each Game OS cached on the console. The callback function provides a [FourPartVersion](https://docs.xbox.com/reference/tools/xtf/xtfapi/structs/fourpartversion-xtfapi-xbox-windows-s.md) 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](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfcachetitleos-xtfapi-xbox-windows-m.md) function, or remove an existing Game OS from the cache by calling the [XtfRemoveTitleOSFromCache](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfremovetitleosfromcache-xtfapi-xbox-windows-m.md) or [XtfRemoveTitleOSFromCacheByVersion](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfremovetitleosfromcachebyversion-xtfapi-xbox-windows-m.md) functions. For more information about managing provisioned Game OS files, see [Application Management (xbapp.exe) (NDA topic)](https://docs.xbox.com/tools/tools-console/commandlinetools/xbapp.md) and [Provision (xbprovision.exe) (NDA topic)](https://docs.xbox.com/tools/tools-console/commandlinetools/xbprovision.md).

## Requirements

**Header:** xtfapi.h

**Library:** XtfApi.lib

**Supported platforms:** Windows (for XBOX console tools)

## See also

[Run from PC Deployment (NDA topic)](https://docs.xbox.com/home/setup-install/concepts/deployment.md)\
[XTF Transport Errors (NDA topic)](https://docs.xbox.com/tools/tools-console/commandlinetools/xtf-transport-errors.md)\
[Additional Xtf APIs](https://docs.xbox.com/reference/tools/xtf/xtfapi/atoc-xtfapi.md)


## Related topics

- [XtfGetCachedTitleOSVersionsCallback](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversionscallback-xtfapi-xbox-windows-m.md)
- [XtfGetTitleOSFourPartVersion](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfgettitleosfourpartversion-xtfapi-xbox-windows-m.md)
- [Additional Xtf APIs (API contents)](https://docs.xbox.com/reference/tools/xtf/xtfapi/atoc-xtfapi.md)
- [XtfCacheTitleOS](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfcachetitleos-xtfapi-xbox-windows-m.md)
- [XtfStartTitleOS](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfstarttitleos-xtfapi-xbox-windows-m.md)
