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

# GetRunningProcesses

> IXtfConsoleControlClient::GetRunningProcesses

# IXtfConsoleControlClient::GetRunningProcesses

Provoque l'énumération de tous les processus en cours d'exécution, en appelant un rappel pour chaque processus en cours d'exécution.

## Syntaxe

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

### Paramètres

*pCallback*\
Type : IXtfRunningProcessCallback\*

Pointeur vers l'interface [IXtfRunningProcessCallback](/fr-CA/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback), appelée lorsqu'un processus en cours d'exécution est découvert.

### Valeur de retour

Type : HRESULT

Retourne `S_OK` en cas de réussite; sinon, retourne un code d'erreur HRESULT.

## Remarques

Cette fonction amène l'API XBOX Tools Framework (XTF) à énumérer tous les processus en cours d'exécution sur la console de développement actuelle. Lorsqu'un processus en cours d'exécution est trouvé, l'API XTF appelle la fonction de rappel [OnFoundProcess](/fr-CA/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/methods/ixtfrunningprocesscallback_onfoundprocess) de l'interface [IXtfRunningProcessCallback](/fr-CA/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback) implémentée dans votre application et spécifiée dans `pCallback`. L'API XTF transmet un pointeur vers une structure [XTFPROCESSINFO](/fr-CA/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo), qui décrit le processus en cours d'exécution, lorsqu'elle appelle votre fonction `OnFoundProcess` implémentée.

> [!NOTE]
>
> La mémoire de la structure [XTFPROCESSINFO](/fr-CA/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo) appartient à l'API XBOX Tools Framework (XTF) et est invalidée après chaque appel de votre fonction de rappel [IXtfRunningProcessCallback::OnFoundProcess](/fr-CA/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/methods/ixtfrunningprocesscallback_onfoundprocess). Vous devez copier les informations de la structure si vous en avez besoin ultérieurement.

> [!NOTE]
>
> Pour obtenir la liste des processus en cours d'exécution dans la partition du titre, vous devez ajouter `/title` à l'adresse fournie dans [XtfCreateConsoleClient](/fr-CA/reference/tools/xtf/xtfconsolecontrol/functions/xtfcreateconsolecontrolclient-xtfconsolecontrol-xbox-microsoft-m) lors de la création de l'instance [IXtfConsoleControlClient](/fr-CA/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient); sinon, cette fonction retourne la liste des processus en cours d'exécution dans la partition système.

Pour plus d'informations sur l'affichage de la liste des processus en cours d'exécution à l'aide de XBOX Tools Framework (XTF), consultez [Liste des processus (xbtlist.exe) (rubrique NDA)](/fr-CA/tools/tools-console/commandlinetools/xbtlist).

## Configuration requise

**En-tête :** xtfconsolecontrol.h

**Bibliothèque :** xtfconsolecontrol.lib

**Plateformes prises en charge :** Windows (pour les outils de console XBOX)

## Voir aussi

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


## Related topics

- [IXtfRunningProcessCallback (contenu de l'interface)](/fr-CA/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback.md)
- [OnFoundProcess](/fr-CA/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/methods/ixtfrunningprocesscallback_onfoundprocess.md)
- [XTFPROCESSINFO](/fr-CA/reference/tools/xtf/xtfconsolecontrol/structs/xtfprocessinfo.md)
- [IXtfConsoleControlClient (contenu de l'interface)](/fr-CA/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)
- [Create Build With Process Based Server](/api-reference/multiplayerserver/create-build-with-process-based-server.md)