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