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

# XtfStartTitleOSByGameConfig

> XtfStartTitleOSByGameConfig

# XtfStartTitleOSByGameConfig

Inicia ou reinicia o Game OS com base no conteúdo de um arquivo MicrosoftGame.config armazenado na memória como uma cadeia de caracteres.

<a id="syntaxSection" />

## Sintaxe

```cpp theme={null}
HRESULT XtfStartTitleOSByGameConfig(
         PCWSTR address,
         UINT32 flags,
         PCWSTR gameconfigContents
)  
```

<a id="parametersSection" />

### Parâmetros

*address*\
Tipo: PCWSTR

\[in] O endereço IP do console.

*flags*\
Tipo: UINT32

\[in] Não utilizado no momento, mas reservado para alterações futuras de comportamento.

*gameconfigContents*\
Tipo: PCWSTR

\[in] O conteúdo de um arquivo MicrosoftGame.config.

<a id="retvalSection" />

### Valor retornado

Tipo: HRESULT

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

<a id="remarksSection" />

## Comentários

Use essa função para iniciar ou reiniciar o Game OS com base no conteúdo de um arquivo MicrosoftGame.config armazenado na memória como uma cadeia de caracteres. Se um valor para `address` ou `gameconfigContents` não for especificado, ocorrerá um erro.

Para obter mais informações sobre o conteúdo de um arquivo MicrosoftGame.config, confira [Visão geral do MicrosoftGame.config](/pt-BR/build/core-features/common/game-config/MicrosoftGameConfig-Overview).

<a id="requirements" />

## Requisitos

**Cabeçalho:** xtfapi.h

**Biblioteca:** XtfApi.lib

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

<a id="seealsoSection" />

## Confira também

[Erros de transporte do XTF (tópico sob NDA)](/pt-BR/tools/tools-console/commandlinetools/xtf-transport-errors)\
[APIs adicionais do Xtf](/pt-BR/reference/tools/xtf/xtfapi/atoc-xtfapi)


## Related topics

- [XtfStartTitleOS](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfstarttitleos-xtfapi-xbox-windows-m.md)
- [XtfStartTitleOSByVersion](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbyversion-xtfapi-xbox-windows-m.md)
- [XtfCacheTitleOS](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfcachetitleos-xtfapi-xbox-windows-m.md)
- [XtfRemoveTitleOSFromCache](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfremovetitleosfromcache-xtfapi-xbox-windows-m.md)
- [XtfGetCachedTitleOSVersionsCallback](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversionscallback-xtfapi-xbox-windows-m.md)