WTSRegisterSessionNotificationEx-Funktion (wtsapi32.h)
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 |