WTSRegisterSessionNotificationEx, fonction (wtsapi32.h)
Inscrit la fenêtre spécifiée pour recevoir des notifications de modification de session.
Syntaxe
BOOL WTSRegisterSessionNotificationEx(
[in] HANDLE hServer,
[in] HWND hWnd,
[in] DWORD dwFlags
);
Paramètres
[in] hServer
Handle du serveur retourné par WTSOpenServer ou WTS_CURRENT_SERVER.
[in] hWnd
Handle de la fenêtre pour recevoir des notifications de modification de session.
[in] dwFlags
Spécifie les notifications de session à recevoir. Ce paramètre ne peut être NOTIFY_FOR_THIS_SESSION que si hServer est un serveur distant.
NOTIFY_FOR_THIS_SESSION (0)
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 (1)
Toutes les notifications de session doivent être reçues.
Valeur retournée
Si la fonction réussit, la valeur de retour est TRUE. Sinon, elle est FALSE. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
Si cette fonction est appelée avant le démarrage des services dépendants des services Bureau à distance, 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 WTSUnRegisterSessionNotificationEx avant d’être détruite. Pour chaque appel à cette fonction, il doit y avoir un appel correspondant à WTSUnRegisterSessionNotificationEx.
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 à partir 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 |