WTSRegisterSessionNotificationEx-Funktion (wtsapi32.h)

Artikel
03/13/2024

Registriert das angegebene Fenster, um Sitzungsänderungsbenachrichtigungen zu erhalten.

Syntax

BOOL WTSRegisterSessionNotificationEx(
  [in] HANDLE hServer,
  [in] HWND   hWnd,
  [in] DWORD  dwFlags
);

Parameter

[in] hServer

Handle des Servers, der von WTSOpenServer oder WTS_CURRENT_SERVER zurückgegeben wurde.

[in] hWnd

Handle des Fensters zum Empfangen von Sitzungsänderungsbenachrichtigungen.

[in] dwFlags

Gibt an, welche Sitzungsbenachrichtigungen empfangen werden sollen. Dieser Parameter kann nur NOTIFY_FOR_THIS_SESSION werden, wenn hServer ein Remoteserver ist.

NOTIFY_FOR_THIS_SESSION (0)

Es werden nur Sitzungsbenachrichtigungen empfangen, die die Sitzung betreffen, die durch das durch den hWnd-Parameterwert identifizierte Fenster angefügt ist.

NOTIFY_FOR_ALL_SESSIONS (1)

Alle Sitzungsbenachrichtigungen sind zu empfangen.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE. Andernfalls ist es FALSE. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Wenn diese Funktion aufgerufen wird, bevor die abhängigen Dienste von Remotedesktopdiensten gestartet wurden, wird möglicherweise ein RPC_S_INVALID_BINDING Fehlercode zurückgegeben. Wenn das globale Ereignis "Global\TermSrvReadyEvent" festgelegt ist, wurden alle abhängigen Dienste gestartet, und diese Funktion kann erfolgreich aufgerufen werden.

Sitzungsänderungsbenachrichtigungen werden in Form einer WM_WTSSESSION_CHANGE Nachricht gesendet. Diese Benachrichtigungen werden nur an die Fenster gesendet, die sich mit dieser Funktion für sie registriert haben.

Wenn ein Fenster diese Benachrichtigungen nicht mehr erfordert, muss es WTSUnRegisterSessionNotificationEx aufrufen, bevor es zerstört wird. Für jeden Aufruf dieser Funktion muss ein entsprechender Aufruf von WTSUnRegisterSessionNotificationEx vorhanden sein.

Wenn das in dieser Funktion übergebene Fensterhandle bereits registriert ist, wird der Wert des dwFlags-Parameters ignoriert.

Verwenden Sie die HandlerEx-Funktion , um Sitzungsänderungsbenachrichtigungen von einem Dienst zu erhalten.

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