> ## 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.

# XtfRemoveTitleOSFromCacheByVersion

> XtfRemoveTitleOSFromCacheByVersion

# XtfRemoveTitleOSFromCacheByVersion

Removes the Game OS matching the specified [FourPartVersion](/reference/tools/xtf/xtfapi/structs/fourpartversion-xtfapi-xbox-windows-s) from the cache on the console.

<a id="syntaxSection" />

## Syntax

```cpp theme={null}
HRESULT XtfRemoveTitleOSFromCacheByVersion(
         PCWSTR address,
         FourPartVersion version
)  
```

<a id="parametersSection" />

### Parameters

*address*<br />Type: PCWSTR

\[in] The address of the console.

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

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

<a id="retvalSection" />

### Return value

Type: HRESULT

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

<a id="remarksSection" />

## Remarks

Use this function to manage provisioned Game OS files by removing the Game OS matching the specified `FourPartVersion` from the cache on the console. You can use the [XtfGetCachedTitleOSVersions](/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversions-xtfapi-xbox-windows-m) function to get the `FourPartVersion` of each Game OS cached on the console, or the [XtfGetTitleOSFourPartVersion](/reference/tools/xtf/xtfapi/functions/xtfgettitleosfourpartversion-xtfapi-xbox-windows-m) function to get the `FourPartVersion` of the Game OS for the currently running title. If you attempt to remove a Game OS flagged as a fallback OS, an error occurs.

If you don't have a [FourPartVersion](/reference/tools/xtf/xtfapi/structs/fourpartversion-xtfapi-xbox-windows-s) for the Game OS you want to remove, use the [XtfRemoveTitleOSFromCache](/reference/tools/xtf/xtfapi/functions/xtfremovetitleosfromcache-xtfapi-xbox-windows-m) function instead to remove a Game OS by specifying a different identifier, such as the full path and file name of the GameOs.vxd file for the Game OS to be removed.

You can also add a Game OS to the cache on the console by calling the [XtfCacheTitleOS](/reference/tools/xtf/xtfapi/functions/xtfcachetitleos-xtfapi-xbox-windows-m) function. 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

[Run from PC Deployment (NDA topic)](/home/setup-install/concepts/deployment)<br />[XTF Transport Errors (NDA topic)](/tools/tools-console/commandlinetools/xtf-transport-errors)<br />[Additional Xtf APIs](/reference/tools/xtf/xtfapi/atoc-xtfapi)


## Related topics

- [XtfRemoveTitleOSFromCache](/reference/tools/xtf/xtfapi/functions/xtfremovetitleosfromcache-xtfapi-xbox-windows-m.md)
- [XtfCacheTitleOS](/reference/tools/xtf/xtfapi/functions/xtfcachetitleos-xtfapi-xbox-windows-m.md)
- [XtfGetCachedTitleOSVersions](/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversions-xtfapi-xbox-windows-m.md)
- [XtfGetCachedTitleOSVersionsCallback](/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversionscallback-xtfapi-xbox-windows-m.md)
- [FourPartVersion](/reference/tools/xtf/xtfapi/structs/fourpartversion-xtfapi-xbox-windows-s.md)