WTSWaitSystemEvent-Funktion (wtsapi32.h)
Wartet auf ein Remotedesktopdienste-Ereignis, bevor er zum Aufrufer zurückkehrt.
Syntax
BOOL WTSWaitSystemEvent(
[in] HANDLE hServer,
[in] DWORD EventMask,
[out] DWORD *pEventFlags
);
Parameter
[in] hServer
Verarbeiten mit einem RD-Sitzungshostserver. Geben Sie ein Von der WTSOpenServer-Funktion geöffnetes Handle an, oder geben Sie WTS_CURRENT_SERVER_HANDLE an, um den RD-Sitzungshostserver anzugeben, auf dem Ihre Anwendung ausgeführt wird.
[in] EventMask
Bitmaske, die den Satz von Ereignissen angibt, auf die gewartet werden soll. Diese Maske kann WTS_EVENT_FLUSH werden, damit alle ausstehenden WTSWaitSystemEvent-Aufrufe auf dem angegebenen RD-Sitzungshostserverhandle zurückgegeben werden. Oder die Maske kann eine Kombination der folgenden Werte sein.
WTS_EVENT_ALL
Warten Sie auf einen beliebigen Ereignistyp.
WTS_EVENT_CONNECT
Ein Client, der mit einer WinStation verbunden ist.
WTS_EVENT_CREATE
Eine neue WinStation wurde erstellt.
WTS_EVENT_DELETE
Eine vorhandene WinStation wurde gelöscht.
WTS_EVENT_DISCONNECT
Ein Client, der von einer WinStation getrennt ist.
WTS_EVENT_LICENSE
Der Lizenzstatus der Remotedesktopdienste hat sich geändert. Dies tritt auf, wenn eine Lizenz mithilfe des Lizenz-Managers hinzugefügt oder gelöscht wird.
WTS_EVENT_LOGOFF
Ein Benutzer hat sich entweder von der Remotedesktopdienste-Konsole oder von einer WinStation des Clients abgemeldet.
WTS_EVENT_LOGON
Ein Benutzer hat sich entweder über die Remotedesktopdienste-Konsole oder über eine WinStation des Clients beim System angemeldet.
WTS_EVENT_RENAME
Eine vorhandene WinStation wurde umbenannt.
WTS_EVENT_STATECHANGE
Ein WinStation-Verbindungsstatus wurde geändert. Eine Liste der Verbindungszustände finden Sie im WTS_CONNECTSTATE_CLASS Enumerationstyp.
[out] pEventFlags
Zeiger auf eine Variable, die eine Bitmaske des aufgetretenen Ereignisses empfängt. Die zurückgegebene Maske kann eine Kombination der Werte aus der vorherigen Liste sein, oder sie kann WTS_EVENT_NONE werden, wenn die Wartezeit aufgrund eines WTSWaitSystemEvent-Aufrufs mit WTS_EVENT_FLUSH beendet wurde.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Nichtzero-Wert.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | wtsapi32.h |
| Bibliothek | Wtsapi32.lib |
| DLL | Wtsapi32.dll |