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 .