Structure WTSLISTENERCONFIGW (wtsapi32.h)
Contient des informations sur un écouteur des services Bureau à distance. Cette structure est utilisée par la fonction WTSCreateListener
Syntaxe
typedef struct _WTSLISTENERCONFIGW {
ULONG version;
ULONG fEnableListener;
ULONG MaxConnectionCount;
ULONG fPromptForPassword;
ULONG fInheritColorDepth;
ULONG ColorDepth;
ULONG fInheritBrokenTimeoutSettings;
ULONG BrokenTimeoutSettings;
ULONG fDisablePrinterRedirection;
ULONG fDisableDriveRedirection;
ULONG fDisableComPortRedirection;
ULONG fDisableLPTPortRedirection;
ULONG fDisableClipboardRedirection;
ULONG fDisableAudioRedirection;
ULONG fDisablePNPRedirection;
ULONG fDisableDefaultMainClientPrinter;
ULONG LanAdapter;
ULONG PortNumber;
ULONG fInheritShadowSettings;
ULONG ShadowSettings;
ULONG TimeoutSettingsConnection;
ULONG TimeoutSettingsDisconnection;
ULONG TimeoutSettingsIdle;
ULONG SecurityLayer;
ULONG MinEncryptionLevel;
ULONG UserAuthentication;
WCHAR Comment[WTS_COMMENT_LENGTH + 1];
WCHAR LogonUserName[USERNAME_LENGTH + 1];
WCHAR LogonDomain[DOMAIN_LENGTH + 1];
WCHAR WorkDirectory[MAX_PATH + 1];
WCHAR InitialProgram[MAX_PATH + 1];
} WTSLISTENERCONFIGW, *PWTSLISTENERCONFIGW;
Membres
version
Ce membre est réservé.
fEnableListener
Spécifie si l’écouteur est activé. Ce membre peut être l’une des valeurs suivantes.
0
L’écouteur est désactivé.
1
L’écouteur est activé.
MaxConnectionCount
Nombre maximal de connexions actives que l’écouteur accepte.
fPromptForPassword
Spécifie si l’écouteur invite toujours l’utilisateur à entrer un mot de passe. Ce membre peut être l’une des valeurs suivantes.
0
Invitez l’utilisateur à entrer un mot de passe uniquement lorsqu’il est spécifié par le serveur.
1
Invitez toujours l’utilisateur à entrer un mot de passe.
fInheritColorDepth
Spécifie si l’écouteur doit utiliser la profondeur de couleur spécifiée par l’utilisateur. Ce membre peut être l’une des valeurs suivantes.
0
Utilisez la profondeur de couleur spécifiée par le serveur.
1
Utilisez la profondeur de couleur spécifiée par l’utilisateur.
ColorDepth
Paramètre de profondeur de couleur pour l’écouteur. Ce paramètre s’applique uniquement lorsque le membre fInheritColorDepth est égal à zéro. Il peut s’agir de l’une des valeurs suivantes.
1
8 bits
2
15 bits
3
16 bits
4
24 bits
5
32 bits
fInheritBrokenTimeoutSettings
Spécifie si l’écouteur doit utiliser l'BrokenTimeoutSettings valeur spécifiée par l’utilisateur. Ce membre peut être l’une des valeurs suivantes.
0
Utilisez la valeur BrokenTimeoutSettings spécifiée par le serveur.
1
Utilisez la valeur BrokenTimeoutSettings spécifiée par l’utilisateur.
BrokenTimeoutSettings
Action effectuée par l’écouteur lorsqu’une connexion ou un minuteur inactif expire, ou lorsqu’une connexion est perdue en raison d’une erreur de connexion. Ce paramètre s’applique uniquement lorsque le membre fInheritBrokenTimeoutSettings est égal à zéro. Ce membre peut être l’une des valeurs suivantes.
0
Lorsqu’une connexion ou un minuteur inactif expire, ou lorsqu’une connexion est perdue en raison d’une erreur de connexion, l’utilisateur est déconnecté, mais la session reste sur le serveur.
1
Lorsqu’une connexion ou un minuteur inactif expire, ou lorsqu’une connexion est perdue en raison d’une erreur de connexion, la session est arrêtée.
fDisablePrinterRedirection
Spécifie si la redirection d’imprimante est désactivée. Ce membre peut être l’une des valeurs suivantes.
0
L’utilisateur peut activer la redirection d’imprimante.
1
La redirection d’imprimante est désactivée.
fDisableDriveRedirection
Spécifie si la redirection de lecteur est désactivée. Ce membre peut être l’une des valeurs suivantes.
0
L’utilisateur peut activer la redirection de lecteur.
1
La redirection de lecteur est désactivée.
fDisableComPortRedirection
Spécifie si la redirection de port COM est désactivée. Ce membre peut être l’une des valeurs suivantes.
0
L’utilisateur peut activer la redirection de port COM.
1
La redirection de port COM est désactivée.
fDisableLPTPortRedirection
Spécifie si la redirection de port LPT est désactivée. Ce membre peut être l’une des valeurs suivantes.
0
L’utilisateur peut activer la redirection de port LPT.
1
La redirection de port LPT est désactivée.
fDisableClipboardRedirection
Spécifie si la redirection du Presse-papiers est désactivée. Ce membre peut être l’une des valeurs suivantes.
0
L’utilisateur peut activer la redirection du Presse-papiers.
1
La redirection du Presse-papiers est désactivée.
fDisableAudioRedirection
Spécifie si la redirection audio est désactivée. Ce membre peut être l’une des valeurs suivantes.
0
L’utilisateur peut activer la redirection audio.
1
La redirection audio est désactivée.
fDisablePNPRedirection
Spécifie si la redirection Plug-and-Play est désactivée. Ce membre peut être l’une des valeurs suivantes.
0
L’utilisateur peut activer la redirection Plug-and-Play.
1
La redirection Plug-and-Play est désactivée.
fDisableDefaultMainClientPrinter
Spécifie si l’imprimante cliente est l’imprimante par défaut. Ce membre peut être l’une des valeurs suivantes.
0
L’imprimante cliente n’est pas l’imprimante par défaut.
1
L’imprimante cliente est l’imprimante par défaut.
LanAdapter
Carte réseau utilisée par l’écouteur.
PortNumber
Numéro de port de l’écouteur.
fInheritShadowSettings
Spécifie si l’écouteur doit utiliser la ShadowSettings valeur spécifiée par l’utilisateur. Ce membre peut être l’une des valeurs suivantes.
0
Utilisez le paramètre spécifié par le serveur.
1
Utilisez le paramètre spécifié par l’utilisateur.
ShadowSettings
Paramètre de contrôle à distance de l’écouteur. Le contrôle à distance permet à un utilisateur de surveiller à distance les opérations à l’écran d’un autre utilisateur. Ce paramètre s’applique uniquement lorsque le membre fInheritShadowSettings est égal à zéro. Ce membre peut être l’une des valeurs suivantes.
0
Le contrôle à distance est désactivé.
1
L’utilisateur du contrôle à distance a un contrôle total de la session de l’utilisateur, avec l’autorisation de l’utilisateur.
2
L’utilisateur du contrôle à distance a un contrôle total de la session de l’utilisateur ; l’autorisation de l’utilisateur n’est pas requise.
3
L’utilisateur du contrôle à distance peut afficher la session à distance, avec l’autorisation de l’utilisateur ; l’utilisateur distant ne peut pas contrôler activement la session.
4
L’utilisateur du contrôle à distance peut afficher la session à distance, mais pas contrôler activement la session ; l’autorisation de l’utilisateur n’est pas requise.
TimeoutSettingsConnection
Durée maximale de la connexion, en millisecondes. Chaque fois que l’utilisateur se connecte, le minuteur est réinitialisé. La valeur zéro indique que le minuteur de connexion est désactivé.
TimeoutSettingsDisconnection
Durée maximale, en millisecondes, qu’un serveur conserve une session déconnectée avant la fin de l’ouverture de session. La valeur zéro indique que le minuteur de déconnexion est désactivé.
TimeoutSettingsIdle
Durée d’inactivité maximale, en millisecondes. La valeur zéro indique que le minuteur d’inactivité est désactivé.
SecurityLayer
Couche de sécurité de l’écouteur. Ce membre peut être l’une des valeurs suivantes.
0
Le protocole RDP (Remote Desktop Protocol) est utilisé par le serveur et le client pour l’authentification avant l’établissement d’une connexion.
1
Le serveur et le client négocient la méthode d’authentification avant l’établissement d’une connexion.
2
Le protocole TLS (Transport Layer Security) est utilisé par le serveur et le client pour l’authentification avant l’établissement d’une connexion.
MinEncryptionLevel
Niveau de chiffrement de l’écouteur. Ce membre peut être l’une des valeurs suivantes.
1
Les données envoyées du client au serveur sont chiffrées à l’aide du chiffrement 56 bits. Les données envoyées du serveur au client ne sont pas chiffrées.
2
Toutes les données envoyées du client au serveur et du serveur au client sont chiffrées à l’aide de la puissance maximale de clé prise en charge par le client.
3
Toutes les données envoyées du client au serveur et du serveur au client sont chiffrées à l’aide du chiffrement 128 bits. Les clients qui ne prennent pas en charge ce niveau de chiffrement ne peuvent pas se connecter.
4
Toutes les données envoyées du client au serveur et du serveur au client sont chiffrées et déchiffrées à l’aide des algorithmes de chiffrement FIPS (Federal Information Processing Standards) et des modules de chiffrement Microsoft.
UserAuthentication
Spécifie si l’authentification utilisateur au niveau du réseau est requise avant l’établissement de la connexion. Ce membre peut être l’une des valeurs suivantes.
0
L’authentification utilisateur au niveau du réseau n’est pas nécessaire.
1
L’authentification utilisateur au niveau du réseau est requise.
Comment[WTS_COMMENT_LENGTH + 1]
Chaîne terminée par null qui contient une description de l’écouteur.
LogonUserName[USERNAME_LENGTH + 1]
Chaîne terminée par null qui contient le nom d’utilisateur utilisé dans les scénarios d’ouverture de session automatique.
LogonDomain[DOMAIN_LENGTH + 1]
Chaîne terminée par null qui contient le nom de domaine utilisé dans les scénarios d’ouverture de session automatique.
WorkDirectory[MAX_PATH + 1]
Chaîne terminée par null qui contient le chemin d’accès du répertoire de travail du programme initial.
InitialProgram[MAX_PATH + 1]
Chaîne terminée par null qui contient le nom du programme à démarrer immédiatement après que l’utilisateur se connecte au serveur.
Remarques
Note
L’en-tête wtsapi32.h définit WTSLISTENERCONFIG 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 |
| d’en-tête | wtsapi32.h |