Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
L’API Services Bureau à distance vous permet d’énumérer et de gérer des serveurs hôtes de session Bureau à distance (hôte de session Bureau à distance), des sessions clientes et des 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 sur un serveur hôte de session Bureau à distance spécifique, passez 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 boîte de message sur l’affichage du 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 à la fin 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 l’ouverture de session utilisateur sur le serveur hôte de session Bureau à distance. |
Plusieurs de ces fonctions allouent des mémoires tampons pour retourner des informations à l’appelant. Lorsque vous avez terminé d’utiliser la mémoire tampon, libérez-la en appelant la fonction WTSFreeMemory.