Funzione WTSRegisterSessionNotification (wtsapi32.h)
Registra la finestra specificata per ricevere notifiche di modifica della sessione.
Sintassi
BOOL WTSRegisterSessionNotification(
[in] HWND hWnd,
[in] DWORD dwFlags
);
Parametri
[in] hWnd
Handle della finestra per ricevere notifiche di modifica della sessione.
[in] dwFlags
Specifica quali notifiche di sessione devono essere ricevute. Questo parametro può avere uno dei valori seguenti.
NOTIFY_FOR_THIS_SESSION
Verranno ricevute solo le notifiche di sessione che coinvolgono la sessione collegata dalla finestra identificata dal valore del parametro hWnd .
NOTIFY_FOR_ALL_SESSIONS
Tutte le notifiche di sessione devono essere ricevute.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è TRUE. In caso contrario, è FALSE. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Se questa funzione viene chiamata prima dell'avvio dei servizi desktop remoto, potrebbe essere restituito un codice di errore RPC_S_INVALID_BINDING . Quando l'evento globale\TermSrvReadyEvent è impostato, tutti i servizi dipendenti sono stati avviati e questa funzione può essere chiamata correttamente.
Le notifiche di modifica della sessione vengono inviate sotto forma di messaggio di WM_WTSSESSION_CHANGE . Queste notifiche vengono inviate solo alle finestre registrate per loro usando questa funzione.
Quando una finestra non richiede più queste notifiche, deve chiamare WTSUnRegisterSessionNotification prima di essere distrutta. Per ogni chiamata a questa funzione, deve essere presente una chiamata corrispondente a WTSUnRegisterSessionNotification.
Se l'handle della finestra passato in questa funzione è già registrato, il valore del parametro dwFlags viene ignorato.
Per ricevere notifiche di modifica della sessione da un servizio, usare la funzione HandlerEx .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | wtsapi32.h |
| Libreria | Wtsapi32.lib |
| DLL | Wtsapi32.dll |
| Set di API | ext-ms-win-session-wtsapi32-l1-1-0 (introdotta in Windows 8) |