WTSSetListenerSecurityW, fonction (wtsapi32.h)
Configure le descripteur de sécurité d’un écouteur des services Bureau à distance.
Syntaxe
BOOL WTSSetListenerSecurityW(
[in] HANDLE hServer,
[in] PVOID pReserved,
[in] DWORD Reserved,
[in] LPWSTR pListenerName,
[in] SECURITY_INFORMATION SecurityInformation,
[in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);
Paramètres
[in] hServer
Handle vers un serveur hôte de session Bureau à distance. Définissez toujours ce paramètre sur WTS_CURRENT_SERVER_HANDLE.
[in] pReserved
Ce paramètre est réservé. Définissez toujours ce paramètre sur NULL.
[in] Reserved
Ce paramètre est réservé. Définissez toujours ce paramètre sur zéro.
[in] pListenerName
Pointeur vers une chaîne terminée par null qui contient le nom de l’écouteur.
[in] SecurityInformation
Valeur SECURITY_INFORMATION qui spécifie les informations de sécurité à définir. Activez toujours les indicateurs DACL_SECURITY_INFORMATION et SACL_SECURITY_INFORMATION.
Pour plus d’informations sur les valeurs possibles, consultez SECURITY_INFORMATION.
[in] pSecurityDescriptor
Pointeur vers une structure SECURITY_DESCRIPTOR qui contient les informations de sécurité associées à l’écouteur. Pour plus d’informations sur les valeurs possibles, consultez SECURITY_DESCRIPTOR. Pour plus d’informations sur STANDARD_RIGHTS_REQUIRED, consultez droits d’accès standard.
La liste de contrôle d’accès discrétionnaire (DACL) du descripteur de sécurité peut contenir une ou plusieurs des valeurs suivantes.
WTS_SECURITY_ALL_ACCESS
Combine ces valeurs :
- 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))
Droit de se connecter.
WTS_SECURITY_CURRENT_GUEST_ACCESS
Combine ces valeurs :
- WTS_SECURITY_LOGOFF
- WTS_SECURITY_VIRTUAL_CHANNELS
WTS_SECURITY_CURRENT_USER_ACCESS
Combine ces valeurs :
- WTS_SECURITY_DISCONNECT
- WTS_SECURITY_LOGOFF
- WTS_SECURITY_RESET
- WTS_SECURITY_SET_INFORMATION
- WTS_SECURITY_VIRTUAL_CHANNELS
WTS_SECURITY_DISCONNECT (512 (0x200))
Droit de se déconnecter.
WTS_SECURITY_GUEST_ACCESS
Défini comme WTS_SECURITY_LOGON.
WTS_SECURITY_LOGOFF (64 (0x40))
Droit de se déconnecter.
WTS_SECURITY_LOGON (32 (0x20))
Droit de se connecter.
WTS_SECURITY_MESSAGE (128 (0x80))
Droit d’envoyer un message à l’utilisateur.
WTS_SECURITY_QUERY_INFORMATION (1 (0x1))
Droit d’interroger des informations.
WTS_SECURITY_REMOTE_CONTROL (16 (0x10))
Droit d’utiliser le contrôle à distance.
WTS_SECURITY_RESET (4 (0x4))
Droit de réinitialiser les informations.
WTS_SECURITY_SET_INFORMATION (2 (0x2))
Droit de définir des informations.
WTS_SECURITY_USER_ACCESS
Combine ces valeurs :
- WTS_SECURITY_CONNECT
- WTS_SECURITY_CURRENT_GUEST_ACCESS
- WTS_SECURITY_QUERY_INFORMATION
WTS_SECURITY_VIRTUAL_CHANNELS (8 (0x8))
Droit d’utiliser des canaux virtuels.
Valeur de retour
Si la fonction réussit, la valeur de retour est une valeur différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations d’erreur étendues, appelez la fonction GetLastError.
Remarques
Note
L’en-tête wtsapi32.h définit WTSSetListenerSecurity comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 7 |
| serveur minimum pris en charge | Windows Server 2008 R2 |
| plateforme cible | Windows |
| d’en-tête | wtsapi32.h |
| bibliothèque | Wtsapi32.lib |
| DLL | Wtsapi32.dll |