> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

## Sintaxe

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

### Parâmetros

*pCallback*\
Tipo: IXtfRunningProcessCallback\*

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

### 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 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](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/methods/ixtfrunningprocesscallback_onfoundprocess.md) da interface [IXtfRunningProcessCallback](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback.md) implementada no seu aplicativo e especificada em `pCallback`. A API do XTF passa um ponteiro para uma estrutura [XTFPROCESSINFO](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md), que descreve o processo em execução, ao invocar a função `OnFoundProcess` que você implementou.

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

> [!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](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/functions/xtfcreateconsolecontrolclient-xtfconsolecontrol-xbox-microsoft-m.md) ao criar a instância de [IXtfConsoleControlClient](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md); caso contrário, essa função retornará a lista de processos em execução na partição do sistema.

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)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbtlist.md).

## Requisitos

**Cabeçalho:** xtfconsolecontrol.h

**Biblioteca:** xtfconsolecontrol.lib

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

## Confira também

[IXtfConsoleControlClient](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)\
[XtfConsoleControl](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members.md)


## Related topics

- [IXtfRunningProcessCallback (conteúdo da interface)](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback.md)
- [OnFoundProcess](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/methods/ixtfrunningprocesscallback_onfoundprocess.md)
- [XtfConsoleControl (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members.md)
- [XTFPROCESSINFO](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md)
- [IXtfConsoleControlClient (conteúdo da interface)](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)