Administración de Servicios de Escritorio remoto
La API de Servicios de Escritorio remoto permite enumerar y administrar servidores de host de sesión de Escritorio remoto (host de sesión de Escritorio remoto), sesiones de cliente y procesos.
Para recuperar los nombres de todos los servidores host de sesión de Escritorio remoto de un dominio, llame a la función NetServerEnum para enumerar los servidores del tipo SV_TYPE_TERMINALSERVER. Para abrir un identificador en un servidor host de sesión de Escritorio remoto específico, pase el nombre del servidor en una llamada a la función WTSOpenServer . Cuando haya terminado de usar el identificador, suéltelo llamando a la función WTSCloseServer .
Puede usar el identificador devuelto por WTSOpenServer para realizar las siguientes operaciones en el servidor.
| Función | Operación |
|---|---|
| WTSDisconnectSession | Desconecta el cliente de una sesión especificada. La sesión permanece activa y el usuario puede iniciar sesión de nuevo para conectarse a la misma sesión. |
| WTSEnumerateSessions | Devuelve una lista de sesiones en el servidor host de sesión de Escritorio remoto especificado. |
| WTSEnumerateProcesses | Devuelve una lista de procesos en el servidor host de sesión de Escritorio remoto especificado. |
| WTSLogoffSession | Cierra la sesión especificada. |
| WTSQuerySessionInformation | Devuelve información sobre la sesión especificada en el servidor host de sesión de Escritorio remoto especificado. |
| WTSSendMessage | Muestra un cuadro de mensaje en la presentación del cliente de una sesión especificada. |
| WTSShutdownSystem | Apaga y, opcionalmente, reinicia un servidor host de sesión de Escritorio remoto especificado. |
| WTSTerminateProcess | Finaliza un proceso especificado en un servidor host de sesión de Escritorio remoto especificado. |
| WTSVirtualChannelOpen | Abre un identificador al final del servidor de un canal virtual especificado. Para obtener más información sobre los canales virtuales, consulte Uso de canales virtuales de Servicios de Escritorio remoto. |
| WTSWaitSystemEvent | Espera un evento, como la creación de una sesión de cliente o un usuario que inicia sesión en el servidor host de sesión de Escritorio remoto. |
Varias de estas funciones asignan búferes para devolver información al autor de la llamada. Cuando haya terminado de usar el búfer, libere el búfer llamando a la función WTSFreeMemory .