Fonction WTSWaitSystemEvent (wtsapi32.h)
Attend un événement services Bureau à distance avant de revenir à l’appelant.
Syntaxe
BOOL WTSWaitSystemEvent(
[in] HANDLE hServer,
[in] DWORD EventMask,
[out] DWORD *pEventFlags
);
Paramètres
[in] hServer
Gérez vers un serveur hôte de session Bureau à distance. Spécifiez un handle ouvert par la fonction WTSOpenServer ou spécifiez WTS_CURRENT_SERVER_HANDLE pour indiquer le serveur hôte de session Bureau à distance sur lequel votre application s’exécute.
[in] EventMask
Masque de bits qui spécifie le jeu d’événements à attendre. Ce masque peut être WTS_EVENT_FLUSH pour provoquer le retour de tous les appels WTSWaitSystemEvent en attente sur le handle de serveur hôte de session Bureau à distance spécifié. Ou bien, le masque peut être une combinaison des valeurs suivantes.
WTS_EVENT_ALL
Attendez n’importe quel type d’événement.
WTS_EVENT_CONNECT
Un client connecté à une WinStation.
WTS_EVENT_CREATE
Une nouvelle WinStation a été créée.
WTS_EVENT_DELETE
Une WinStation existante a été supprimée.
WTS_EVENT_DISCONNECT
Un client déconnecté d’une WinStation.
WTS_EVENT_LICENSE
L’état de licence des services Bureau à distance a changé. Cela se produit lorsqu’une licence est ajoutée ou supprimée à l’aide du Gestionnaire de licences.
WTS_EVENT_LOGOFF
Un utilisateur s’est déconnecté de la console Services Bureau à distance ou d’un client WinStation.
WTS_EVENT_LOGON
Un utilisateur s’est connecté au système à partir de la console Services Bureau à distance ou d’un client WinStation.
WTS_EVENT_RENAME
Une WinStation existante a été renommée.
WTS_EVENT_STATECHANGE
Un état de connexion WinStation a changé. Pour obtenir la liste des états de connexion, consultez le type d’énumération WTS_CONNECTSTATE_CLASS .
[out] pEventFlags
Pointeur vers une variable qui reçoit un masque de bits de l’événement ou des événements qui se sont produits. Le masque retourné peut être une combinaison des valeurs de la liste précédente, ou il peut être WTS_EVENT_NONE si l’attente s’est terminée en raison d’un appel WTSWaitSystemEvent avec WTS_EVENT_FLUSH.
Valeur retournée
Si la fonction réussit, la valeur de retour est une valeur différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
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 |