WTSEnumerateProcessesW, fonction (wtsapi32.h)

Article
11/20/2024

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 WTSEnumerateProcessesW(
  [in]  HANDLE             hServer,
  [in]  DWORD              Reserved,
  [in]  DWORD              Version,
  [out] PWTS_PROCESS_INFOW *ppProcessInfo,
  [out] DWORD              *pCount
);

Paramètres

[in] hServer

Gérer 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é; doit être égal à zéro.

[in] Version

Spécifie la version de la demande d’énumération. Doit être 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 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 GetLastError.

Remarques

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

Note

L’en-tête wtsapi32.h définit WTSEnumerateProcesses 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 Vista
serveur minimum pris en charge	Windows Server 2008
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)

Voir aussi

WTS_PROCESS_INFO

Partager via