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

# IXtfConsoleControlClient::GetRunningProcesses

> IXtfConsoleControlClient::GetRunningProcesses

# IXtfConsoleControlClient::GetRunningProcesses

Faz com que todos os processos em execução sejam enumerados, invocando um retorno de chamada para cada processo em execução.

<a id="syntaxSection" />

## Sintaxe

```cpp theme={null}
HRESULT GetRunningProcesses(
         IXtfRunningProcessCallback *pCallback
)  
```

<a id="parametersSection" />

### Parâmetros

*pCallback*\
Tipo: IXtfRunningProcessCallback\*

Um ponteiro para a interface [IXtfRunningProcessCallback](/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback), invocada quando um processo em execução é descoberto.

<a id="retvalSection" />

### Valor retornado

Tipo: HRESULT

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

<a id="remarksSection" />

## Comentários

Essa função faz com que a API do XBOX Tools Framework (XTF) enumere todos os processos em execução no console de desenvolvimento atual. Quando um processo em execução é encontrado, a API do XTF invoca a função de retorno de chamada [OnFoundProcess](/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/methods/ixtfrunningprocesscallback_onfoundprocess) da interface [IXtfRunningProcessCallback](/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback) implementada no seu aplicativo e especificada em `pCallback`. A API do XTF passa um ponteiro para uma estrutura [XTFPROCESSINFO](/pt-BR/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo), que descreve o processo em execução, ao invocar a função `OnFoundProcess` que você implementou.

<Note>A memória da estrutura [XTFPROCESSINFO](/pt-BR/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo) pertence à API do XBOX Tools Framework (XTF) e é invalidada após cada invocação da sua função de retorno de chamada [IXtfRunningProcessCallback::OnFoundProcess](/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/methods/ixtfrunningprocesscallback_onfoundprocess). Você deve copiar as informações da estrutura se precisar delas para uso posterior.</Note>

<Note>Para obter a lista de processos em execução na partição do título, você precisa acrescentar `/title` ao endereço fornecido em [XtfCreateConsoleClient](/pt-BR/reference/tools/xtf/xtfconsolecontrol/functions/xtfcreateconsolecontrolclient-xtfconsolecontrol-xbox-microsoft-m) ao criar a instância de [IXtfConsoleControlClient](/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient); caso contrário, essa função retornará a lista de processos em execução na partição do sistema.</Note>

Para obter mais informações sobre como listar processos em execução usando o XBOX Tools Framework (XTF), consulte [Lista de processos (xbtlist.exe) (tópico sob NDA)](/pt-BR/tools/tools-console/commandlinetools/xbtlist).

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** xtfconsolecontrol.h

**Biblioteca:** xtfconsolecontrol.lib

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

<a id="seealsoSection" />

## Confira também

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


## Related topics

- [IXtfRunningProcessCallback](/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback.md)
- [IXtfRunningProcessCallback::OnFoundProcess](/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/methods/ixtfrunningprocesscallback_onfoundprocess.md)
- [XTFPROCESSINFO](/pt-BR/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md)
- [IXtfConsoleControlClient](/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)
- [IXtfConsoleControlClient::GenerateStackDump](/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_generatestackdump.md)