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

# XtfCacheTitleOS

> XtfCacheTitleOS

# XtfCacheTitleOS

Adiciona um Game OS ao cache do sistema operacional.

## Sintaxe

```cpp theme={null}
HRESULT XtfCacheTitleOS(
         PCWSTR address,
         PCWSTR osIdentifier
)  
```

### Parâmetros

*address*\
Tipo: PCWSTR

\[in] O endereço do console.

*osIdentifier*\
Tipo: PCWSTR

\[in] O identificador do Game OS a ser adicionado. Esse identificador pode ser um dos seguintes:

* O caminho completo e o nome de arquivo de um arquivo MicrosoftGame.config que contém o número de versão de quatro partes da versão do Game OS a ser adicionada
* O caminho completo e o nome de arquivo de um arquivo GameOs.xvd
* O caminho completo para um diretório que contém um arquivo MicrosoftGame.config ou GameOS.vxd
* O número de versão de quatro partes do Game OS a ser adicionado

Exemplos de identificadores válidos:

* D:\MyGame
* \MyDevPC\share\MyGame\MicrosoftGame.config
* xd:\Titles\MyGamePFN\GameOs.xvd
* 10.0.18236.1002

### Valor de retorno

Tipo: HRESULT

Retorna `S_OK` se tiver êxito; caso contrário, retorna um código de erro HRESULT.

## Comentários

Use esta função para gerenciar arquivos do Game OS provisionados adicionando o Game OS especificado ao cache no console. Você pode usar a função [XtfGetCachedTitleOSVersions](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversions-xtfapi-xbox-windows-m.md) para obter as informações de versão de cada Game OS armazenado em cache no console. Você também pode remover um Game OS existente do cache chamando as funções [XtfRemoveTitleOSFromCache](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfremovetitleosfromcache-xtfapi-xbox-windows-m.md) ou [XtfRemoveTitleOSFromCacheByVersion](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfremovetitleosfromcachebyversion-xtfapi-xbox-windows-m.md). Para obter mais informações sobre como gerenciar arquivos do Game OS provisionados, confira [Gerenciamento de aplicativos (xbapp.exe) (tópico sob NDA)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbapp.md) e [Provisionamento (xbprovision.exe) (tópico sob NDA)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbprovision.md).

## Requisitos

**Cabeçalho:** xtfapi.h

**Biblioteca:** XtfApi.lib

**Plataformas com suporte:** Windows (para ferramentas de console XBOX)

## Confira também

[Implantação Executar a partir do PC (tópico sob NDA)](https://docs.xbox.com/pt-BR/home/setup-install/concepts/deployment.md)\
[Erros de transporte do XTF (tópico sob NDA)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xtf-transport-errors.md)\
[APIs adicionais do Xtf](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/atoc-xtfapi.md)


## Related topics

- [XtfRemoveTitleOSFromCache](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfremovetitleosfromcache-xtfapi-xbox-windows-m.md)
- [XtfRemoveTitleOSFromCacheByVersion](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfremovetitleosfromcachebyversion-xtfapi-xbox-windows-m.md)
- [XtfGetCachedTitleOSVersions](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversions-xtfapi-xbox-windows-m.md)
- [XtfStartTitleOS](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfstarttitleos-xtfapi-xbox-windows-m.md)
- [XtfStartTitleOSByVersion](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbyversion-xtfapi-xbox-windows-m.md)