Condividi tramite

Funzione WTSGetListenerSecurityW (wtsapi32.h)

  • Articolo

Recupera il descrittore di sicurezza di un listener di Servizi Desktop remoto.

Sintassi

BOOL WTSGetListenerSecurityW(
  [in]            HANDLE               hServer,
  [in]            PVOID                pReserved,
  [in]            DWORD                Reserved,
  [in]            LPWSTR               pListenerName,
  [in]            SECURITY_INFORMATION SecurityInformation,
  [out, optional] PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in]            DWORD                nLength,
  [out]           LPDWORD              lpnLengthNeeded
);

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 recuperare. Abilitare sempre i flag DACL_SECURITY_INFORMATION e SACL_SECURITY_INFORMATION.

Per altre informazioni sui valori possibili, vedere SECURITY_INFORMATION.

[out, optional] pSecurityDescriptor

Puntatore a una struttura SECURITY_DESCRIPTOR che riceve le informazioni di sicurezza associate al listener a cui fa riferimento il parametro pListenerName. La struttura SECURITY_DESCRIPTOR viene restituita in formato auto-relativo. Per altre informazioni sui valori possibili, vedere SECURITY_DESCRIPTOR.

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.

[in] nLength

Dimensioni, in byte, della struttura SECURITY_DESCRIPTOR a cui fa riferimento il parametro pSecurityDescriptor .

[out] lpnLengthNeeded

Puntatore a una variabile che riceve il numero di byte necessari per archiviare il descrittore di sicurezza completo. Se questo numero è minore o uguale al valore del parametro nLength, il descrittore di sicurezza viene copiato nella struttura di SECURITY_DESCRIPTOR a cui fa riferimento il parametro pSecurityDescriptor; in caso contrario, non viene eseguita alcuna azione.

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

Se il numero di byte necessari per il buffer che riceve la struttura SECURITY_DESCRIPTOR è sconosciuto, è possibile chiamare questo metodo con nLength impostato su zero. Il metodo restituirà quindi, nel parametro lpnLengthNeeded, il numero di byte necessari per il buffer. Allocare il buffer in base a questo numero e quindi chiamare di nuovo il metodo impostando pSecurityDescriptor sul buffer appena allocato e nLength al numero restituito dalla prima chiamata.

Nota

L'intestazione wtsapi32.h definisce WTSGetListenerSecurity 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