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

Weitere Informationen

WTSOpenServer