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, ábrelo llamando a la función WTSFreeMemory .