Fonction WTSRegisterSessionNotification (wtsapi32.h)
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) |