Función WTSRegisterSessionNotification (wtsapi32.h)

Artículo
03/13/2024

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)