WTSRegisterSessionNotificationEx-Funktion (wtsapi32.h)
Registriert das angegebene Fenster zum Empfangen von Sitzungsänderungsbenachrichtigungen.
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 wird.
[in] hWnd
Behandeln 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)
Nur Sitzungsbenachrichtigungen, die an die vom hWnd-Parameterwert angegebene Sitzung angefügt sind, werden empfangen.
NOTIFY_FOR_ALL_SESSIONS (1)
Alle Sitzungsbenachrichtigungen werden empfangen.
Rückgabewert
Wenn die Funktion erfolgreich ist, lautet der Rückgabewert WAHR. Andernfalls ist es FALSCH. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Bemerkungen
Wenn diese Funktion aufgerufen wird, bevor die abhängigen Dienste von Remotedesktopdiensten gestartet wurden, kann ein RPC_S_INVALID_BINDING Fehlercode zurückgegeben werden. 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 für sie mit dieser Funktion registriert haben.
Wenn ein Fenster diese Benachrichtigungen nicht mehr benötigt, muss er WTSUnRegisterSessionNotificationEx aufrufen, bevor er zerstört wird. Für jeden Aufruf dieser Funktion muss ein entsprechender Aufruf von WTSUnRegisterSessionNotificationEx vorhanden sein.
Wenn das in dieser Funktion übergebene Fensterziehpunkt bereits registriert ist, wird der Wert des dwFlags-Parameters ignoriert.
Verwenden Sie die HandlerEx-Funktion , um Sitzungsänderungsbenachrichtigungen von einem Dienst zu empfangen.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | wtsapi32.h |
| Bibliothek | Wtsapi32.lib |
| DLL | Wtsapi32.dll |