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

# XtfGetTitleOSFourPartVersion

> XtfGetTitleOSFourPartVersion

# XtfGetTitleOSFourPartVersion

Obtém informações de versão sobre o Game OS do título em execução no momento.

## Sintaxe

```cpp theme={null}
HRESULT XtfGetTitleOSFourPartVersion(
         PCWSTR address,
         UINT32* flags,
         FourPartVersion* version
)
```

### Parâmetros

*address*\
Tipo: PCWSTR

\[in] O endereço do console.

*flags*\
Tipo: UINT32\*

\[out] Uma combinação OR bit a bit de sinalizadores que fornecem informações adicionais sobre o Game OS. Esse parâmetro dá suporte aos seguintes sinalizadores:

| Sinalizador | Valor | Descrição |
| - | - | - |
| XTF\_CACHED\_TITLE\_OS\_IS\_FALLBACK | 0x0001 | Indica que esse Game OS é o sistema operacional de fallback, que não pode ser excluído nem substituído. |

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

\[out] O número de versão de quatro partes do Game OS.

### Valor retornado

Tipo: HRESULT

Retorna `S_OK` se for bem-sucedido; caso contrário, retorna um código de erro HRESULT.

## Comentários

Use essa função para retornar informações de versão sobre o Game OS do título em execução no momento. Se não houver nenhum Game OS em execução no momento, ocorrerá um erro. Você também pode usar a função [XtfGetCachedTitleOSVersions](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversions-xtfapi-xbox-windows-m.md) para retornar informações de versão sobre outras versões do Game OS armazenadas em cache no console. Para obter mais informações sobre como gerenciar arquivos provisionados do Game OS, confira [Gerenciamento de aplicativos (xbapp.exe) (tópico sob NDA)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbapp.md) e [Provisionamentoamento (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)\
[XtfGetPackageFullName](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgetpackagefullname-xtfapi-xbox-windows-m.md)\
[XtfGetAumid](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgetaumid-xtfapi-xbox-windows-m.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

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