Partager via


WTSEnumerateProcessesA, fonction (wtsapi32.h)

Récupère des informations sur les processus actifs sur un serveur hôte de session Bureau à distance (hôte de session Bureau à distance) spécifié.

Syntaxe

BOOL WTSEnumerateProcessesA(
  [in]  HANDLE             hServer,
  [in]  DWORD              Reserved,
  [in]  DWORD              Version,
  [out] PWTS_PROCESS_INFOA *ppProcessInfo,
  [out] DWORD              *pCount
);

Paramètres

[in] hServer

Gérez 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 hôte de session Bureau à distance sur lequel votre application s’exécute.

[in] Reserved

Réservés au; doit être égal à zéro.

[in] Version

Spécifie la version de la demande d’énumération. Doit être égal à 1.

[out] ppProcessInfo

Pointeur vers une variable qui reçoit un pointeur vers un tableau de structures WTS_PROCESS_INFO . Chaque structure du tableau contient des informations sur un processus actif sur le serveur hôte de session Bureau à distance spécifié. Pour libérer la mémoire tampon retournée, appelez la fonction WTSFreeMemory .

[out] pCount

Pointeur vers une variable qui reçoit le nombre de structures WTS_PROCESS_INFO retournées dans la mémoire tampon 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 GetLastError.

Remarques

L’appelant doit être membre du groupe Administrateurs pour énumérer les processus qui s’exécutent dans un contexte d’utilisateur différent.

Notes

L’en-tête wtsapi32.h définit WTSEnumerateProcesses en tant qu’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. La combinaison 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 Vista
Serveur minimal pris en charge Windows Server 2008
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)

Voir aussi

WTS_PROCESS_INFO