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 .