Estructura WTSLISTENERCONFIGA (wtsapi32.h)
Contiene información sobre un agente de escucha de Servicios de Escritorio remoto. Esta estructura la usa la función
Sintaxis
typedef struct _WTSLISTENERCONFIGA {
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;
CHAR Comment[WTS_COMMENT_LENGTH + 1];
CHAR LogonUserName[USERNAME_LENGTH + 1];
CHAR LogonDomain[DOMAIN_LENGTH + 1];
CHAR WorkDirectory[MAX_PATH + 1];
CHAR InitialProgram[MAX_PATH + 1];
} WTSLISTENERCONFIGA, *PWTSLISTENERCONFIGA;
Miembros
version
Este miembro está reservado.
fEnableListener
Especifica si el agente de escucha está habilitado. Este miembro puede ser uno de los siguientes valores.
0
El agente de escucha está deshabilitado.
1
El agente de escucha está habilitado.
MaxConnectionCount
Número máximo de conexiones activas que acepta el agente de escucha.
fPromptForPassword
Especifica si el agente de escucha siempre solicita al usuario una contraseña. Este miembro puede ser uno de los siguientes valores.
0
Pida al usuario una contraseña solo cuando lo especifique el servidor.
1
Pida siempre al usuario una contraseña.
fInheritColorDepth
Especifica si el agente de escucha debe usar la profundidad de color especificada por el usuario. Este miembro puede ser uno de los siguientes valores.
0
Use la profundidad de color especificada por el servidor.
1
Use la profundidad de color especificada por el usuario.
ColorDepth
Configuración de profundidad de color para el agente de escucha. Esta configuración solo se aplica cuando el fInheritColorDepth miembro es cero. Puede ser uno de los siguientes valores.
1
8 bits
2
15 bits
3
16 bits
4
24 bits
5
32 bits
fInheritBrokenTimeoutSettings
Especifica si el agente de escucha debe usar el BrokenTimeoutSettings valor especificado por el usuario. Este miembro puede ser uno de los siguientes valores.
0
Use el BrokenTimeoutSettings valor especificado por el servidor.
1
Use el brokenTimeoutSettings valor especificado por el usuario.
BrokenTimeoutSettings
La acción que toma el agente de escucha cuando expira una conexión o un temporizador de inactividad, o cuando se pierde una conexión debido a un error de conexión. Esta configuración solo se aplica cuando el fInheritBrokenTimeoutSettings miembro es cero. Este miembro puede ser uno de los siguientes valores.
0
Cuando expira una conexión o un temporizador de inactividad, o cuando se pierde una conexión debido a un error de conexión, el usuario está desconectado, pero la sesión permanece en el servidor.
1
Cuando expira una conexión o un temporizador de inactividad, o cuando se pierde una conexión debido a un error de conexión, se finaliza la sesión.
fDisablePrinterRedirection
Especifica si el redireccionamiento de impresora está deshabilitado. Este miembro puede ser uno de los siguientes valores.
0
El usuario puede habilitar el redireccionamiento de impresoras.
1
La redirección de impresora está deshabilitada.
fDisableDriveRedirection
Especifica si la redirección de unidades está deshabilitada. Este miembro puede ser uno de los siguientes valores.
0
El usuario puede habilitar el redireccionamiento de unidades.
1
La redirección de unidades está deshabilitada.
fDisableComPortRedirection
Especifica si el redireccionamiento de puertos COM está deshabilitado. Este miembro puede ser uno de los siguientes valores.
0
El usuario puede habilitar el redireccionamiento de puertos COM.
1
La redirección de puertos COM está deshabilitada.
fDisableLPTPortRedirection
Especifica si el redireccionamiento de puertos LPT está deshabilitado. Este miembro puede ser uno de los siguientes valores.
0
El usuario puede habilitar el redireccionamiento de puertos LPT.
1
El redireccionamiento de puertos LPT está deshabilitado.
fDisableClipboardRedirection
Especifica si el redireccionamiento del Portapapeles está deshabilitado. Este miembro puede ser uno de los siguientes valores.
0
El usuario puede habilitar el redireccionamiento del Portapapeles.
1
El redireccionamiento del Portapapeles está deshabilitado.
fDisableAudioRedirection
Especifica si el redireccionamiento de audio está deshabilitado. Este miembro puede ser uno de los siguientes valores.
0
El usuario puede habilitar el redireccionamiento de audio.
1
El redireccionamiento de audio está deshabilitado.
fDisablePNPRedirection
Especifica si el redireccionamiento de Plug and Play está deshabilitado. Este miembro puede ser uno de los siguientes valores.
0
El usuario puede habilitar el redireccionamiento de Plug and Play.
1
La redirección de Plug and Play está deshabilitada.
fDisableDefaultMainClientPrinter
Especifica si la impresora cliente es la impresora predeterminada. Este miembro puede ser uno de los siguientes valores.
0
La impresora cliente no es la impresora predeterminada.
1
La impresora cliente es la impresora predeterminada.
LanAdapter
Adaptador de red que usa el agente de escucha.
PortNumber
Número de puerto del agente de escucha.
fInheritShadowSettings
Especifica si el agente de escucha debe usar el shadowSettings valor especificado por el usuario. Este miembro puede ser uno de los siguientes valores.
0
Use la configuración especificada por el servidor.
1
Use la configuración especificada por el usuario.
ShadowSettings
Configuración de control remoto para el agente de escucha. El control remoto permite a un usuario supervisar de forma remota las operaciones en pantalla de otro usuario. Esta configuración solo se aplica cuando el fInheritShadowSettings miembro es cero. Este miembro puede ser uno de los siguientes valores.
0
El control remoto está deshabilitado.
1
El usuario del control remoto tiene control total de la sesión del usuario, con el permiso del usuario.
2
El usuario del control remoto tiene control total de la sesión del usuario; No se requiere el permiso del usuario.
3
El usuario del control remoto puede ver la sesión de forma remota, con el permiso del usuario; el usuario remoto no puede controlar activamente la sesión.
4
El usuario del control remoto puede ver la sesión de forma remota, pero no controlar activamente la sesión; No se requiere el permiso del usuario.
TimeoutSettingsConnection
Duración máxima de la conexión, en milisegundos. Cada vez que el usuario inicia sesión, se restablece el temporizador. Un valor de cero indica que el temporizador de conexión está deshabilitado.
TimeoutSettingsDisconnection
Duración máxima, en milisegundos, que un servidor conserva una sesión desconectada antes de que finalice el inicio de sesión. Un valor de cero indica que el temporizador de desconexión está deshabilitado.
TimeoutSettingsIdle
Tiempo de inactividad máximo, en milisegundos. Un valor de cero indica que el temporizador de inactividad está deshabilitado.
SecurityLayer
Capa de seguridad del agente de escucha. Este miembro puede ser uno de los siguientes valores.
0
El servidor usa el protocolo de escritorio remoto (RDP) y el cliente para la autenticación antes de establecer una conexión.
1
El servidor y el cliente negocian el método de autenticación antes de establecer una conexión.
2
El servidor usa el protocolo de seguridad de la capa de transporte (TLS) y el cliente para la autenticación antes de establecer una conexión.
MinEncryptionLevel
Nivel de cifrado del agente de escucha. Este miembro puede ser uno de los siguientes valores.
1
Los datos enviados desde el cliente al servidor se cifran mediante el cifrado de 56 bits. Los datos enviados desde el servidor al cliente no están cifrados.
2
Todos los datos enviados desde el cliente al servidor y desde el servidor al cliente se cifran mediante la máxima intensidad de clave admitida por el cliente.
3
Todos los datos enviados desde el cliente al servidor y desde el servidor al cliente se cifran mediante el cifrado de 128 bits. Los clientes que no admiten este nivel de cifrado no se pueden conectar.
4
Todos los datos enviados desde el cliente al servidor y desde el servidor al cliente se cifran y descifran mediante los algoritmos de cifrado Federal Information Processing Standards (FIPS) y los módulos criptográficos de Microsoft.
UserAuthentication
Especifica si se requiere la autenticación de usuario de nivel de red antes de establecer la conexión. Este miembro puede ser uno de los siguientes valores.
0
No se requiere la autenticación de usuario de nivel de red.
1
Se requiere la autenticación de usuario de nivel de red.
Comment[WTS_COMMENT_LENGTH + 1]
Cadena terminada en NULL que contiene una descripción del agente de escucha.
LogonUserName[USERNAME_LENGTH + 1]
Cadena terminada en NULL que contiene el nombre de usuario usado en escenarios de inicio de sesión automático.
LogonDomain[DOMAIN_LENGTH + 1]
Cadena terminada en NULL que contiene el nombre de dominio usado en escenarios de inicio de sesión automático.
WorkDirectory[MAX_PATH + 1]
Cadena terminada en NULL que contiene la ruta de acceso del directorio de trabajo del programa inicial.
InitialProgram[MAX_PATH + 1]
Cadena terminada en null que contiene el nombre del programa que se iniciará inmediatamente después de que el usuario inicie sesión en el servidor.
Observaciones
Nota
El encabezado wtsapi32.h define WTSLISTENERCONFIG como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 7 |
| servidor mínimo admitido | Windows Server 2008 R2 |
| encabezado de |
wtsapi32.h |