> ## 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::QueryExecutionState

> IXtfApplicationClient::QueryExecutionState

# IXtfApplicationClient::QueryExecutionState

Consulta o estado de execução do aplicativo com o moniker de pacote especificado.

<a id="syntaxSection" />

## Sintaxe

```cpp theme={null}
public:
HRESULT QueryExecutionState(
         LPCWSTR pszPackageMoniker,
         DWORD *dwState
)  
```

<a id="parametersSection" />

### Parâmetros

*pszPackageMoniker*<br />Tipo: LPCWSTR

Um ponteiro para o moniker de pacote do aplicativo a ser consultado.

*dwState*<br />Tipo: DWORD\*

Um ponteiro que recebe o estado de execução do aplicativo. Este parâmetro é definido como um dos valores listados na tabela a seguir.

| Constante | Valor | Descrição |
| - | - | - |
| Unknown | 0 | O estado de execução do aplicativo é desconhecido. |
| Running | 1 | O aplicativo está em execução no momento. |
| Suspending | 2 | O aplicativo está em processo de suspensão. |
| Suspended | 3 | A execução do aplicativo está suspensa no momento. |
| Terminated | 4 | O aplicativo foi encerrado. |

<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

Este método consulta o estado de execução do aplicativo com o nome de pacote especificado. Este método é semelhante ao comando `xbapp query` da ferramenta Gerenciamento de aplicativos (xbapp.exe), incluída como parte do XBOX Tools Framework (XTF). Para obter mais informações sobre o comando `xbapp query`, confira [Gerenciamento de aplicativos (xbapp.exe) (tópico sob NDA)](/pt-BR/tools/tools-console/commandlinetools/xbapp).

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

[Interface 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::DebugQuery](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/ixtfapplicationclient-debugquery.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)
- [IXtfApplicationClient::Launch](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/launch-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)
- [IXtfApplicationClient::Resume](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/resume-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)