Condividi tramite


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)

Vedi anche

HandlerEx

WM_WTSSESSION_CHANGE

WTSGetActiveConsoleSessionId

WTSRegisterSessionNotificationEx

WTSSESSION_NOTIFICATION

WTSUnRegisterSessionNotification