Funzione WTSRegisterSessionNotificationEx (wtsapi32.h)

Articolo
03/04/2024

Registra la finestra specificata per ricevere notifiche di modifica della sessione.

Sintassi

BOOL WTSRegisterSessionNotificationEx(
  [in] HANDLE hServer,
  [in] HWND   hWnd,
  [in] DWORD  dwFlags
);

Parametri

[in] hServer

Handle del server restituito da WTSOpenServer o WTS_CURRENT_SERVER.

[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ò essere NOTIFY_FOR_THIS_SESSION solo se hServer è un server remoto.

NOTIFY_FOR_THIS_SESSION (0)

Verranno ricevute solo le notifiche di sessione che coinvolgono la sessione collegata dalla finestra identificata dal valore del parametro hWnd .

NOTIFY_FOR_ALL_SESSIONS (1)

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 "Global\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 WTSUnRegisterSessionNotificationEx prima di essere distrutta. Per ogni chiamata a questa funzione, deve essere presente una chiamata corrispondente a WTSUnRegisterSessionNotificationEx.

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