Partager via


Administration des services Bureau à distance

L’API Des services Bureau à distance vous permet d’énumérer et de gérer les serveurs hôtes de session Bureau à distance (hôte de session Bureau à distance), les sessions clientes et les processus.

Pour récupérer les noms de tous les serveurs hôtes de session Bureau à distance dans un domaine, appelez la fonction NetServerEnum pour énumérer les serveurs du type SV_TYPE_TERMINALSERVER. Pour ouvrir un handle à un serveur hôte de session Bureau à distance spécifique, transmettez le nom du serveur dans un appel à la fonction WTSOpenServer . Une fois que vous avez terminé d’utiliser le handle, relâchez-le en appelant la fonction WTSCloseServer .

Vous pouvez utiliser le handle retourné par WTSOpenServer pour effectuer les opérations suivantes sur le serveur.

Fonction Opération
WTSDisconnectSession Déconnecte le client d’une session spécifiée. La session reste active et l’utilisateur peut se reconnecter pour se connecter à la même session.
WTSEnumerateSessions Retourne une liste de sessions sur le serveur hôte de session Bureau à distance spécifié.
WTSEnumerateProcesses Retourne une liste de processus sur le serveur hôte de session Bureau à distance spécifié.
WTSLogoffSession Déconnecte la session spécifiée.
WTSQuerySessionInformation Retourne des informations sur la session spécifiée sur le serveur hôte de session Bureau à distance spécifié.
WTSSendMessage Affiche une zone de message sur l’affichage client d’une session spécifiée.
WTSShutdownSystem Arrête et redémarre éventuellement un serveur hôte de session Bureau à distance spécifié.
WTSTerminateProcess Met fin à un processus spécifié sur un serveur hôte de session Bureau à distance spécifié.
WTSVirtualChannelOpen Ouvre un handle à l’extrémité du serveur d’un canal virtuel spécifié. Pour plus d’informations sur les canaux virtuels, consultez Utilisation des canaux virtuels des services Bureau à distance.
WTSWaitSystemEvent Attend un événement, tel que la création d’une session cliente ou la connexion d’un utilisateur au serveur hôte de session Bureau à distance.

 

Plusieurs de ces fonctions allouent des mémoires tampons pour retourner des informations à l’appelant. Une fois que vous avez terminé d’utiliser la mémoire tampon, libérez-la en appelant la fonction WTSFreeMemory .