WTSSetListenerSecurityA, fonction (wtsapi32.h)
Configure le descripteur de sécurité d’un écouteur des services Bureau à distance.
Syntaxe
BOOL WTSSetListenerSecurityA(
[in] HANDLE hServer,
[in] PVOID pReserved,
[in] DWORD Reserved,
[in] LPSTR pListenerName,
[in] SECURITY_INFORMATION SecurityInformation,
[in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);
Paramètres
[in] hServer
Handle pour 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 de 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 les valeurs suivantes :
- 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 connexion.
WTS_SECURITY_CURRENT_GUEST_ACCESS
Combine les valeurs suivantes :
- WTS_SECURITY_LOGOFF
- WTS_SECURITY_VIRTUAL_CHANNELS
WTS_SECURITY_CURRENT_USER_ACCESS
Combine les valeurs suivantes :
- WTS_SECURITY_DISCONNECT
- WTS_SECURITY_LOGOFF
- WTS_SECURITY_RESET
- WTS_SECURITY_SET_INFORMATION
- WTS_SECURITY_VIRTUAL_CHANNELS
WTS_SECURITY_DISCONNECT (512 (0x200))
Droit à la déconnexion.
WTS_SECURITY_GUEST_ACCESS
Défini comme WTS_SECURITY_LOGON.
WTS_SECURITY_LOGOFF (64 (0x40))
Droit de déconnexion.
WTS_SECURITY_LOGON (32 (0x20))
Droit de connexion.
WTS_SECURITY_MESSAGE (128 (0x80))
Droit d’envoyer un message à l’utilisateur.
WTS_SECURITY_QUERY_INFORMATION (1 (0x1))
Droit de demander 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 les valeurs suivantes :
- 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 retournée
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étaillées sur l’erreur, appelez la fonction GetLastError.
Remarques
Notes
L’en-tête wtsapi32.h définit WTSSetListenerSecurity en tant qu’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. La combinaison 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.
Spécifications
| Client minimal pris en charge | Windows 7 |
| Serveur minimal pris en charge | Windows Server 2008 R2 |
| Plateforme cible | Windows |
| En-tête | wtsapi32.h |
| Bibliothèque | Wtsapi32.lib |
| DLL | Wtsapi32.dll |