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

# ShutdownConsole

> IXtfConsoleControlClient::ShutdownConsole

# IXtfConsoleControlClient::ShutdownConsole

Desliga o console de desenvolvimento.

## Sintaxe

```cpp theme={null}
HRESULT ShutdownConsole(
         DWORD dwFlags
)  
```

### Parâmetros

*dwFlags*\
Tipo: DWORD

Uma combinação OR bit a bit de sinalizadores que especificam como desligar o console de desenvolvimento. A tabela a seguir lista os sinalizadores disponíveis:

| Valor | Constante | Descrição |
| - | - | - |
| 0x00000001 | XTFSHUTDOWN\_REBOOT | Desliga e reinicializa o console de desenvolvimento. |
| 0x00000002 | XTFSHUTDOWN\_POWER\_MODE\_AWARE | Desliga e reinicializa o console de desenvolvimento de acordo com as configurações de modo de energia do console. |

### Valor retornado

Tipo: HRESULT

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

## Comentários

Essa função desliga o console de desenvolvimento atual, dependendo da combinação de sinalizadores especificada em `dwFlags`. Se o sistema não estiver pronto para aceitar uma solicitação de desligamento no momento em que a função for invocada, a função incluirá lógica de repetição, como tentar desligar o console usando o Host OS como alternativa caso o System OS não esteja acessível. A função tenta desligar o console até ser bem-sucedida ou atingir o tempo limite após 5 minutos e retornar um erro.

Para obter mais informações sobre como desligar e reinicializar um console usando o XBOX Tools Framework (XTF), consulte [Reinicialização (xbreboot.exe) (tópico sob NDA)](/pt-BR/tools/tools-console/commandlinetools/xbreboot).

## Requisitos

**Cabeçalho:** xtfconsolecontrol.h

**Biblioteca:** xtfconsolecontrol.lib

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

## Confira também

[IXtfConsoleControlClient](/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient)\
[XtfConsoleControl](/pt-BR/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members)


## Related topics

- [IXtfConsoleControlClient (conteúdo da interface)](/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)
- [XtfShutdownTitleOS](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfshutdowntitleos-xtfapi-xbox-windows-m.md)
- [Shutdown Multiplayer Server](/api-reference/multiplayerserver/shutdown-multiplayer-server.md)
- [MsQuic](/pt-BR/build/console-features/networking/game-mesh/msquic-intro-networking.md)
- [Reinicialização (xbreboot.exe)](/pt-BR/tools/tools-console/commandlinetools/xbreboot.md)