Fonction WTSEnumerateProcessesExA (wtsapi32.h)
Récupère des informations sur les processus actifs sur le serveur hôte de session Bureau à distance (hôte de session Bureau à distance) ou l’hôte de virtualisation Bureau à distance (hôte de virtualisation bureau à distance).
Syntaxe
BOOL WTSEnumerateProcessesExA(
[in] HANDLE hServer,
[in, out] DWORD *pLevel,
[in] DWORD SessionId,
[out] LPSTR *ppProcessInfo,
[out] DWORD *pCount
);
Paramètres
[in] hServer
Handle vers un serveur hôte de session Bureau à distance. Spécifiez un handle ouvert par la fonction WTSOpenServer ou spécifiez WTS_CURRENT_SERVER_HANDLE pour indiquer le serveur sur lequel votre application s’exécute.
[in, out] pLevel
Pointeur vers une variable DWORD qui, en entrée, spécifie le type d’informations à retourner. Pour retourner un tableau de structures WTS_PROCESS_INFO , spécifiez zéro. Pour retourner un tableau de structures WTS_PROCESS_INFO_EX , spécifiez-en une.
Si vous ne spécifiez pas de valeur valide pour ce paramètre, sur la sortie, WTSEnumerateProcessesEx définit ce paramètre sur une valeur et retourne une erreur. Sinon, en sortie, WTSEnumerateProcessesEx ne modifie pas la valeur de ce paramètre.
[in] SessionId
Session pour laquelle énumérer les processus. Pour énumérer les processus de toutes les sessions sur le serveur, spécifiez WTS_ANY_SESSION.
[out] ppProcessInfo
Pointeur vers une variable qui reçoit un pointeur vers un tableau de structures WTS_PROCESS_INFO ou WTS_PROCESS_INFO_EX . Le type de structure est déterminé par la valeur passée au paramètre pLevel . Chaque structure du tableau contient des informations sur un processus actif. Lorsque vous avez terminé d’utiliser le tableau, libérez-le en appelant la fonction WTSFreeMemoryEx . Vous devez également définir le pointeur sur NULL.
[out] pCount
Pointeur vers une variable qui reçoit le nombre de
structures retournées dans la mémoire tampon référencée par le paramètre ppProcessInfo .
Valeur retournée
Si la fonction réussit, la valeur de retour est une valeur différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez la fonction GetLastError.
Remarques
L’appelant doit être membre du groupe Administrateurs pour énumérer les processus qui s’exécutent sous une autre session utilisateur.
Notes
L’en-tête wtsapi32.h définit WTSEnumerateProcessesEx comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 7 |
| Serveur minimal pris en charge | Windows Server 2008 R2 |
| Plateforme cible | Windows |
| En-tête | wtsapi32.h |
| Bibliothèque | Wtsapi32.lib |
| DLL | Wtsapi32.dll |
| Ensemble d’API | ext-ms-win-session-wtsapi32-l1-1-0 (introduit dans Windows 8) |