Función WTSRegisterSessionNotificationEx (wtsapi32.h)

Artículo
03/13/2024

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