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

# XtfStartTitleOSByVersion

> XtfStartTitleOSByVersion

# XtfStartTitleOSByVersion

Inicia ou reinicia o Game OS correspondente à [FourPartVersion](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/structs/fourpartversion-xtfapi-xbox-windows-s.md) especificada a partir do cache no console.

## Sintaxe

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

### Parâmetros

*address*\
Tipo: PCWSTR

\[in] O endereço do console.

*version*\
Tipo: [FourPartVersion](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/structs/fourpartversion-xtfapi-xbox-windows-s.md)

\[in] As informações de versão de quatro partes do Game OS a ser iniciado.

### 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 iniciar ou reiniciar o Game OS correspondente à `FourPartVersion` especificada a partir do 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 a `FourPartVersion` de cada Game OS armazenado em cache no console, ou a função [XtfGetTitleOSFourPartVersion](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgettitleosfourpartversion-xtfapi-xbox-windows-m.md) para obter a `FourPartVersion` do Game OS do título em execução no momento.

Se você não tiver uma [FourPartVersion](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/structs/fourpartversion-xtfapi-xbox-windows-s.md) para o Game OS que deseja iniciar ou reiniciar, use a função [XtfStartTitleOS](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfstarttitleos-xtfapi-xbox-windows-m.md) para iniciar ou reiniciar um Game OS especificando um identificador diferente, como o caminho completo e o nome do arquivo GameOs.vxd de um Game OS. Você também pode usar a função [XtfStartTitleOSByGameConfig](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbygameconfig-xtfapi-xbox-windows-m.md) para iniciar ou reiniciar o Game OS identificado no conteúdo especificado de um arquivo MicrosoftGame.config.

Se necessário, você pode adicionar um Game OS ao cache no console chamando a função [XtfCacheTitleOS](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfcachetitleos-xtfapi-xbox-windows-m.md). Para obter mais informações sobre como gerenciar arquivos de 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 de execução 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

- [XtfStartTitleOS](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfstarttitleos-xtfapi-xbox-windows-m.md)
- [XtfGetCachedTitleOSVersionsCallback](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversionscallback-xtfapi-xbox-windows-m.md)
- [FourPartVersion](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/structs/fourpartversion-xtfapi-xbox-windows-s.md)
- [APIs adicionais do Xtf (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/atoc-xtfapi.md)
- [XtfStartTitleOSByGameConfig](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbygameconfig-xtfapi-xbox-windows-m.md)