Funzione WTSSetListenerSecurityA (wtsapi32.h)
Configura il descrittore di sicurezza di un listener di Servizi Desktop remoto.
Sintassi
BOOL WTSSetListenerSecurityA(
[in] HANDLE hServer,
[in] PVOID pReserved,
[in] DWORD Reserved,
[in] LPSTR pListenerName,
[in] SECURITY_INFORMATION SecurityInformation,
[in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);
Parametri
[in] hServer
Handle per un server Host sessione Desktop remoto. Impostare sempre questo parametro su WTS_CURRENT_SERVER_HANDLE.
[in] pReserved
Questo parametro è riservato. Impostare sempre questo parametro su NULL.
[in] Reserved
Questo parametro è riservato. Impostare sempre questo parametro su zero.
[in] pListenerName
Puntatore a una stringa con terminazione Null contenente il nome del listener.
[in] SecurityInformation
Valore SECURITY_INFORMATION che specifica le informazioni di sicurezza da impostare. Abilitare sempre i flag DACL_SECURITY_INFORMATION e SACL_SECURITY_INFORMATION .
Per altre informazioni sui valori possibili, vedere SECURITY_INFORMATION.
[in] pSecurityDescriptor
Puntatore a una struttura SECURITY_DESCRIPTOR che contiene le informazioni di sicurezza associate al listener. Per altre informazioni sui valori possibili, vedere SECURITY_DESCRIPTOR. Per informazioni sulle STANDARD_RIGHTS_REQUIRED, vedere Diritti di accesso standard.
L'elenco di controllo di accesso discrezionale (DACL) del descrittore di sicurezza può contenere uno o più dei valori seguenti.
WTS_SECURITY_ALL_ACCESS
Combina questi valori:
- STANDARD_RIGHTS_REQUIRED
- WTS_SECURITY_CONNECT
- WTS_SECURITY_DISCONNECT
- WTS_SECURITY_LOGON
- WTS_SECURITY_MESSAGE
- WTS_SECURITY_QUERY_INFORMATION
- WTS_SECURITY_REMOTE_CONTROL
- WTS_SECURITY_RESET
- WTS_SECURITY_SET_INFORMATION
- WTS_SECURITY_VIRTUAL_CHANNELS
WTS_SECURITY_CONNECT (256 (0x100))
Diritto di connessione.
WTS_SECURITY_CURRENT_GUEST_ACCESS
Combina questi valori:
- WTS_SECURITY_LOGOFF
- WTS_SECURITY_VIRTUAL_CHANNELS
WTS_SECURITY_CURRENT_USER_ACCESS
Combina questi valori:
- WTS_SECURITY_DISCONNECT
- WTS_SECURITY_LOGOFF
- WTS_SECURITY_RESET
- WTS_SECURITY_SET_INFORMATION
- WTS_SECURITY_VIRTUAL_CHANNELS
WTS_SECURITY_DISCONNECT (512 (0x200))
Diritto di disconnettersi.
WTS_SECURITY_GUEST_ACCESS
Definito come WTS_SECURITY_LOGON.
WTS_SECURITY_LOGOFF (64 (0x40))
Diritto di disconnettersi.
WTS_SECURITY_LOGON (32 (0x20))
Diritto di accesso.
WTS_SECURITY_MESSAGE (128 (0x80))
Diritto di inviare un messaggio all'utente.
WTS_SECURITY_QUERY_INFORMATION (1 (0x1))
Diritto di eseguire una query per informazioni.
WTS_SECURITY_REMOTE_CONTROL (16 (0x10))
Diritto di utilizzare il controllo remoto.
WTS_SECURITY_RESET (4 (0x4))
Diritto di reimpostare le informazioni.
WTS_SECURITY_SET_INFORMATION (2 (0x2))
Diritto di impostare le informazioni.
WTS_SECURITY_USER_ACCESS
Combina questi valori:
- WTS_SECURITY_CONNECT
- WTS_SECURITY_CURRENT_GUEST_ACCESS
- WTS_SECURITY_QUERY_INFORMATION
WTS_SECURITY_VIRTUAL_CHANNELS (8 (0x8))
Diritto di usare i canali virtuali.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni sull'errore estese, chiamare la funzione GetLastError .
Commenti
Nota
L'intestazione wtsapi32.h definisce WTSSetListenerSecurity come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
| Client minimo supportato | Windows 7 |
| Server minimo supportato | Windows Server 2008 R2 |
| Piattaforma di destinazione | Windows |
| Intestazione | wtsapi32.h |
| Libreria | Wtsapi32.lib |
| DLL | Wtsapi32.dll |