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

# XtfGetCachedTitleOSVersionsCallback

> XtfGetCachedTitleOSVersionsCallback

# XtfGetCachedTitleOSVersionsCallback

Callback invoked for each Game OS found by [XtfGetCachedTitleOSVersions](/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversions-xtfapi-xbox-windows-m).

<a id="syntaxSection" />

## Syntax

```cpp theme={null}
HRESULT XtfGetCachedTitleOSVersionsCallback(
         FourPartVersion version,
         UINT32 flags,
         PVOID context
)  
```

<a id="parametersSection" />

### Parameters

*version*\
Type: [FourPartVersion](/reference/tools/xtf/xtfapi/structs/fourpartversion-xtfapi-xbox-windows-s)

\[in] The four-part version number of the cached Game OS.

*flags*\
Type: UINT32

\[in] A bitwise-OR combination of flags that provide additional information about the cached 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. |

*context*\
Type: PVOID

\[in, optional] A pointer to a context object, passed from `XtfGetCachedTitleOSVersions`.

<a id="retvalSection" />

### Return value

None.

<a id="remarksSection" />

## Remarks

This callback is invoked by `XtfGetCachedTitleOSVersions` for each provisioned Game OS cached on the console. You can use the `FourPartVersion` specified in `version` to invoke the [XtfRemoveTitleOSFromCacheByVersion](/reference/tools/xtf/xtfapi/functions/xtfremovetitleosfromcachebyversion-xtfapi-xbox-windows-m) or [XtfStartTitleOSByVersion](/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbyversion-xtfapi-xbox-windows-m) functions. For more information about managing provisioned Game OS files, see [Application Management (xbapp.exe) (NDA topic)](/tools/tools-console/commandlinetools/xbapp) and [Provision (xbprovision.exe) (NDA topic)](/tools/tools-console/commandlinetools/xbprovision).

<a id="requirementsSection" />

## Requirements

**Header:** xtfapi.h

**Library:** XtfApi.lib

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

<a id="seealsoSection" />

## See also

[XTF Transport Errors (NDA topic)](/tools/tools-console/commandlinetools/xtf-transport-errors)\
[Additional Xtf APIs](/reference/tools/xtf/xtfapi/atoc-xtfapi)


## Related topics

- [XtfGetCachedTitleOSVersions](/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversions-xtfapi-xbox-windows-m.md)
- [XtfGetTitleOSFourPartVersion](/reference/tools/xtf/xtfapi/functions/xtfgettitleosfourpartversion-xtfapi-xbox-windows-m.md)
- [XtfStartTitleOSByVersion](/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbyversion-xtfapi-xbox-windows-m.md)
- [XtfCacheTitleOS](/reference/tools/xtf/xtfapi/functions/xtfcachetitleos-xtfapi-xbox-windows-m.md)
- [XtfStartTitleOS](/reference/tools/xtf/xtfapi/functions/xtfstarttitleos-xtfapi-xbox-windows-m.md)