Fonction WTSRegisterSessionNotification (wtsapi32.h)

Article
03/13/2024

Inscrit la fenêtre spécifiée pour recevoir des notifications de modification de session.

Syntaxe

BOOL WTSRegisterSessionNotification(
  [in] HWND  hWnd,
  [in] DWORD dwFlags
);

Paramètres

[in] hWnd

Gérer la fenêtre pour recevoir les notifications de modification de session.

[in] dwFlags

Spécifie les notifications de session à recevoir. Ce paramètre peut prendre les valeurs suivantes.

NOTIFY_FOR_THIS_SESSION

Seules les notifications de session impliquant la session attachée à par la fenêtre identifiée par la valeur du paramètre hWnd doivent être reçues.

NOTIFY_FOR_ALL_SESSIONS

Toutes les notifications de session doivent être reçues.

Valeur retournée

Si la fonction réussit, la valeur de retour est TRUE. Sinon, il est FALSE. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Si cette fonction est appelée avant que les services dépendants des services Bureau à distance n’aient démarré, un code d’erreur RPC_S_INVALID_BINDING peut être retourné. Lorsque l’événement global Global\TermSrvReadyEvent est défini, tous les services dépendants ont démarré et cette fonction peut être appelée avec succès.

Les notifications de modification de session sont envoyées sous la forme d’un message WM_WTSSESSION_CHANGE . Ces notifications sont envoyées uniquement aux fenêtres qui s’y sont inscrites à l’aide de cette fonction.

Lorsqu’une fenêtre n’a plus besoin de ces notifications, elle doit appeler WTSUnRegisterSessionNotification avant d’être détruite. Pour chaque appel à cette fonction, il doit y avoir un appel correspondant à WTSUnRegisterSessionNotification.

Si le handle de fenêtre passé dans cette fonction est déjà inscrit, la valeur du paramètre dwFlags est ignorée.

Pour recevoir des notifications de modification de session d’un service, utilisez la fonction HandlerEx .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	wtsapi32.h
Bibliothèque	Wtsapi32.lib
DLL	Wtsapi32.dll
Ensemble d’API	ext-ms-win-session-wtsapi32-l1-1-0 (introduit dans Windows 8)