Condividi tramite

Funzione WTSSetListenerSecurityA (wtsapi32.h)

  • Articolo

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 su STANDARD_RIGHTS_REQUIRED, vedere Standard Access Rights.

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 query per ottenere 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 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 estese sull'errore, chiamare la funzione GetLastError .

Osservazioni

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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito Valore
client minimo supportato Windows 7
server minimo supportato Windows Server 2008 R2
piattaforma di destinazione Finestre
intestazione wtsapi32.h
libreria Wtsapi32.lib
dll Wtsapi32.dll

Vedere anche

SECURITY_DESCRIPTOR

SECURITY_INFORMATION