Función WTSRegisterSessionNotificationEx (wtsapi32.h)
Registra la ventana especificada para recibir notificaciones de cambio de sesión.
Sintaxis
BOOL WTSRegisterSessionNotificationEx(
[in] HANDLE hServer,
[in] HWND hWnd,
[in] DWORD dwFlags
);
Parámetros
[in] hServer
Identificador del servidor devuelto desde WTSOpenServer o WTS_CURRENT_SERVER.
[in] hWnd
Identificador de la ventana para recibir notificaciones de cambio de sesión.
[in] dwFlags
Especifica qué notificaciones de sesión se van a recibir. Este parámetro solo puede ser NOTIFY_FOR_THIS_SESSION si hServer es un servidor remoto.
NOTIFY_FOR_THIS_SESSION (0)
Solo se van a recibir las notificaciones de sesión relacionadas con la sesión asociada a por la ventana identificada por el valor del parámetro hWnd .
NOTIFY_FOR_ALL_SESSIONS (1)
Se van a recibir todas las notificaciones de sesión.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es TRUE. De lo contrario, es FALSE. Para obtener información de error extendida, llame a GetLastError.
Comentarios
Si se llama a esta función antes de que se hayan iniciado los servicios dependientes de Servicios de Escritorio remoto, se puede devolver un código de error de RPC_S_INVALID_BINDING . Cuando se establece el evento global "Global\TermSrvReadyEvent", se han iniciado todos los servicios dependientes y se puede llamar correctamente a esta función.
Las notificaciones de cambio de sesión se envían en forma de mensaje de WM_WTSSESSION_CHANGE . Estas notificaciones solo se envían a las ventanas que se han registrado para ellas mediante esta función.
Cuando una ventana ya no requiere estas notificaciones, debe llamar a WTSUnRegisterSessionNotificationEx antes de destruirse. Para cada llamada a esta función, debe haber una llamada correspondiente a WTSUnRegisterSessionNotificationEx.
Si el identificador de ventana pasado en esta función ya está registrado, se omite el valor del parámetro dwFlags .
Para recibir notificaciones de cambio de sesión de un servicio, use la función HandlerEx .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | wtsapi32.h |
| Library | Wtsapi32.lib |
| Archivo DLL | Wtsapi32.dll |