WTSEnumerateProcessesExA, fonction (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 sur le serveur 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, lors de l’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 un.
Si vous ne spécifiez pas de valeur valide pour ce paramètre, lors de la sortie, WTSEnumerateProcessesEx définit ce paramètre sur un 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ées par le paramètre ppProcessInfo
Valeur de retour
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’erreur étendues, 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.
Note
L’en-tête wtsapi32.h définit WTSEnumerateProcessesEx comme 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 7 |
| serveur minimum pris en charge | Windows Server 2008 R2 |
| plateforme cible | Windows |
| d’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) |