Funzione WTSRegisterSessionNotification (wtsapi32.h)

Articolo
03/04/2024

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)