WTSRegisterSessionNotification-Funktion (wtsapi32.h)

Artikel
03/04/2024

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

Syntax

BOOL WTSRegisterSessionNotification(
  [in] HWND  hWnd,
  [in] DWORD dwFlags
);

Parameter

[in] hWnd

Handle des Fensters zum Empfangen von Sitzungsänderungsbenachrichtigungen.

[in] dwFlags

Gibt an, welche Sitzungsbenachrichtigungen empfangen werden sollen. Dieser Parameter kann einen der folgenden Werte annehmen.

NOTIFY_FOR_THIS_SESSION

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

NOTIFY_FOR_ALL_SESSIONS

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 der Remotedesktopdienste 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 benötigt, muss es WTSUnRegisterSessionNotification aufrufen, bevor es zerstört wird. Für jeden Aufruf dieser Funktion muss ein entsprechender Aufruf von WTSUnRegisterSessionNotification 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 empfangen.

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
APIs	ext-ms-win-session-wtsapi32-l1-1-0 (eingeführt in Windows 8)