Condividi tramite

Funzione WTSGetListenerSecurityA (wtsapi32.h)

  • Articolo

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

Sintassi

BOOL WTSGetListenerSecurityA(
  [in]            HANDLE               hServer,
  [in]            PVOID                pReserved,
  [in]            DWORD                Reserved,
  [in]            LPSTR                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 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.

[in] nLength

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

Commenti

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 sul 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 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

Requisito Valore
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