Estructura WTSLISTENERCONFIGA (wtsapi32.h)
Contiene información sobre un agente de escucha de Servicios de Escritorio remoto. Esta estructura la usa la función WTSCreateListener .
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
Solicite 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 miembro fInheritColorDepth 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 valor BrokenTimeoutSettings especificado por el usuario. Este miembro puede ser uno de los siguientes valores.
0
Use el valor BrokenTimeoutSettings especificado por el servidor.
1
Use el valor BrokenTimeoutSettings 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 miembro fInheritBrokenTimeoutSettings 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 se desconecta, 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 la redirección de impresora está deshabilitada. Este miembro puede ser uno de los siguientes valores.
0
El usuario puede habilitar el redireccionamiento de la impresora.
1
La redirección de impresora está deshabilitada.
fDisableDriveRedirection
Especifica si el redireccionamiento de unidades está deshabilitado. Este miembro puede ser uno de los siguientes valores.
0
El usuario puede habilitar el redireccionamiento de unidades.
1
El redireccionamiento de unidades está deshabilitado.
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
El redireccionamiento de puertos COM está deshabilitado.
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 Plug and Play redireccionamiento está deshabilitado. Este miembro puede ser uno de los siguientes valores.
0
El usuario puede habilitar Plug and Play redireccionamiento.
1
Plug and Play redireccionamiento está deshabilitado.
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 valor ShadowSettings especificado por el usuario. Este miembro puede ser uno de los valores siguientes.
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 miembro fInheritShadowSettings es cero. Este miembro puede ser uno de los valores siguientes.
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; El permiso del usuario no es necesario.
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; El permiso del usuario no es necesario.
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
La 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
Nivel de seguridad del agente de escucha. Este miembro puede ser uno de los valores siguientes.
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 valores siguientes.
1
Los datos enviados desde el cliente al servidor se cifran mediante el cifrado de 56 bits. Los datos enviados del servidor al cliente no se cifran.
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 de estándares federales de procesamiento de información (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 valores siguientes.
0
La autenticación de usuario de nivel de red no es necesaria.
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áticos.
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.
Comentarios
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 Convenciones para prototipos de función.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 7 |
| Servidor mínimo compatible | Windows Server 2008 R2 |
| Encabezado | wtsapi32.h |