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

# IXtfApplicationClient::DebugEnable

> IXtfApplicationClient::DebugEnable

# IXtfApplicationClient::DebugEnable

Habilita ou desabilita a depuração do pacote do aplicativo com o moniker de pacote especificado.

<a id="syntaxSection" />

## Sintaxe

```cpp theme={null}
public:
HRESULT DebugEnable(
         LPCWSTR pszPackageMoniker,
         BOOL fEnable
)  
```

<a id="parametersSection" />

### Parâmetros

*pszPackageMoniker*<br />Tipo: LPCWSTR

Um ponteiro para o moniker de pacote do aplicativo.

*fEnable*<br />Tipo: BOOL

Especifique TRUE para habilitar a depuração ou FALSE para desabilitá-la.

<a id="retvalSection" />

### Valor de retorno

Tipo: HRESULT

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

<a id="remarksSection" />

## Comentários

<Note>
  Este método se aplica somente a títulos do XBOX One Software Development Kit\ERA. Invocar este método não tem efeito em títulos do Microsoft Game Development Kit (GDK).
</Note>

Este método habilita ou desabilita a depuração do pacote do aplicativo com o moniker de pacote especificado em `pszPackageMoniker`, definindo ou limpando, respectivamente, o sinalizador de depuração desse pacote.

<Note>
  Você só deve definir o sinalizador de depuração de um pacote quando esse pacote não estiver em execução. Definir o sinalizador de depuração em um pacote em execução pode gerar resultados imprevisíveis.
</Note>

Definir o sinalizador de depuração de um pacote do aplicativo tem os seguintes efeitos para todos os aplicativos no pacote:

* O aplicativo não é encerrado se levar mais de 45 segundos para concluir a ativação.
* O aplicativo não é encerrado se demorar demais para suspender. O limite é de 1 segundo para um aplicativo exclusivo ou 5 segundos para um aplicativo compartilhado.
* O aplicativo não é suspenso depois de perder a visibilidade por muito tempo. O limite é de 10 minutos para aplicativos exclusivos ou 5 segundos para aplicativos compartilhados.
* Para suspender o aplicativo, invoque o comando [xbapp suspend (tópico sob NDA)](/pt-BR/tools/tools-console/commandlinetools/xbapp#xbapp_suspend) ou invoque a função [IXtfApplicationClient::Suspend](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/suspend-ixtfapplicationclient-xtfapplication-xbox-windows).
* Quando seu aplicativo está no modo de depuração, ele não está sujeito aos limites normais do Gerenciamento do Tempo de Vida do Processo (PLM) e só será suspenso ou retomado quando você o instruir a fazer isso usando as ferramentas do XBOX Tools Framework (XTF).

<Note>
  No modo de depuração, seu aplicativo pode ser suspenso em estados nos quais o processo normal do PLM não o suspenderia, como quando ele está visível. Tenha cuidado ao testar o comportamento de suspensão e retomada enquanto seu aplicativo está em execução no modo de depuração, para garantir que você esteja testando o comportamento normal e não os efeitos da execução no modo de depuração.
</Note>

Limpar o sinalizador de depuração de um pacote do aplicativo tem os seguintes efeitos para os aplicativos no pacote:

* O aplicativo é encerrado se levar mais de 45 segundos para concluir a ativação.
* O aplicativo é encerrado se demorar demais para suspender. O limite é de 1 segundo para um aplicativo exclusivo ou 5 segundos para um aplicativo compartilhado.
* O aplicativo é suspenso depois de perder a visibilidade por muito tempo. O limite é de 10 minutos para aplicativos exclusivos ou 5 segundos para aplicativos compartilhados.

O estado do sinalizador de depuração se aplica a todo o pacote. Se você tiver vários aplicativos em um único pacote com o sinalizador de depuração definido, todos os aplicativos serão executados no modo de depuração.

Reinicializar seu kit de desenvolvimento limpa o sinalizador de depuração.

Executar seu aplicativo no Visual Studio com o depurador anexado ao processo do aplicativo, pressionando F5 (**Depurar > Iniciar Depuração**), define automaticamente o sinalizador de depuração antes que seu aplicativo seja executado e limpa o sinalizador depois que o aplicativo é encerrado. Executar seu aplicativo sem anexar o depurador ao processo do aplicativo, pressionando Ctrl+F5 (**Depurar > Iniciar Sem Depuração**), limpa o sinalizador de depuração antes que seu aplicativo seja executado, e o sinalizador permanece limpo depois que seu aplicativo é encerrado. Se seu aplicativo falhar no modo de depuração e o Visual Studio estiver anexado ao seu aplicativo, o Visual Studio limpará o sinalizador de depuração quando for desanexado do seu aplicativo.

O estado do sinalizador de depuração permanece definido nas seguintes situações:

* Se o aplicativo falhar, desde que o depurador do Visual Studio não esteja anexado no momento.
* Durante uma operação de suspensão e retomada.
* Durante um encerramento, desde que o depurador do Visual Studio não esteja anexado no momento.

Para obter mais informações sobre os estados do ciclo de vida do jogo, confira [Ciclo de vida de jogos do XBOX (tópico sob NDA)](/pt-BR/build/console-features/console-workflows/xbox-game-life-cycle).

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** xtfapplication.h

**Biblioteca:** xtfapplication.lib

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

<a id="seealsoSection" />

## Confira também

[IXtfApplicationClient](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t)<br />[XtfApplication](/pt-BR/reference/tools/xtf/xtfapplication/xtfapplication-xbox-microsoft-n)


## Related topics

- [IXtfApplicationClient::Suspend](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/suspend-ixtfapplicationclient-xtfapplication-xbox-windows.md)
- [IXtfApplicationClient::DebugQuery](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/ixtfapplicationclient-debugquery.md)
- [IXtfApplicationClient::EnableGlobalOption](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/enableglobaloption-ixtfapplicationclient-xtfapplication-xb.md)
- [IXtfApplicationClient::Constrain](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/constrain-ixtfapplicationclient-xtfapplication-xbox-windows-m.md)
- [IXtfApplicationClient::Deploy](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/deploy-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)