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

Vedi anche

SECURITY_DESCRIPTOR

SECURITY_INFORMATION