Función WTSRegisterSessionNotification (wtsapi32.h)
Registra la ventana especificada para recibir notificaciones de cambio de sesión.
Sintaxis
BOOL WTSRegisterSessionNotification(
[in] HWND hWnd,
[in] DWORD dwFlags
);
Parámetros
[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 puede ser uno de los valores siguientes.
NOTIFY_FOR_THIS_SESSION
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
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 WTSUnRegisterSessionNotification antes de destruirse. Para cada llamada a esta función, debe haber una llamada correspondiente a WTSUnRegisterSessionNotification.
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 |
| Conjunto de API | ext-ms-win-session-wtsapi32-l1-1-0 (introducido en Windows 8) |