estructura WRDS_CONNECTION_SETTINGS_1 (wtsdefs.h)
Contiene información de configuración de conexión para una sesión remota.
Sintaxis
typedef struct _WRDS_CONNECTION_SETTINGS_1 {
BOOLEAN fInheritInitialProgram;
BOOLEAN fInheritColorDepth;
BOOLEAN fHideTitleBar;
BOOLEAN fInheritAutoLogon;
BOOLEAN fMaximizeShell;
BOOLEAN fDisablePNP;
BOOLEAN fPasswordIsScPin;
BOOLEAN fPromptForPassword;
BOOLEAN fDisableCpm;
BOOLEAN fDisableCdm;
BOOLEAN fDisableCcm;
BOOLEAN fDisableLPT;
BOOLEAN fDisableClip;
BOOLEAN fResetBroken;
BOOLEAN fDisableEncryption;
BOOLEAN fDisableAutoReconnect;
BOOLEAN fDisableCtrlAltDel;
BOOLEAN fDoubleClickDetect;
BOOLEAN fEnableWindowsKey;
BOOLEAN fUsingSavedCreds;
BOOLEAN fMouse;
BOOLEAN fNoAudioPlayback;
BOOLEAN fRemoteConsoleAudio;
BYTE EncryptionLevel;
USHORT ColorDepth;
USHORT ProtocolType;
USHORT HRes;
USHORT VRes;
USHORT ClientProductId;
USHORT OutBufCountHost;
USHORT OutBufCountClient;
USHORT OutBufLength;
ULONG KeyboardLayout;
ULONG MaxConnectionTime;
ULONG MaxDisconnectionTime;
ULONG MaxIdleTime;
ULONG PerformanceFlags;
ULONG KeyboardType;
ULONG KeyboardSubType;
ULONG KeyboardFunctionKey;
ULONG ActiveInputLocale;
ULONG SerialNumber;
ULONG ClientAddressFamily;
ULONG ClientBuildNumber;
ULONG ClientSessionId;
WCHAR WorkDirectory[WTS_DIRECTORY_LENGTH + 1];
WCHAR InitialProgram[WTS_INITIALPROGRAM_LENGTH + 1];
WCHAR UserName[WTS_USERNAME_LENGTH + 1];
WCHAR Domain[WTS_DOMAIN_LENGTH + 1];
WCHAR Password[WTS_PASSWORD_LENGTH + 1];
WCHAR ProtocolName[WTS_PROTOCOL_NAME_LENGTH + 1];
WCHAR DisplayDriverName[WTS_DRIVER_NAME_LENGTH + 1];
WCHAR DisplayDeviceName[WTS_DEVICE_NAME_LENGTH + 1];
WCHAR imeFileName[WTS_IMEFILENAME_LENGTH + 1];
WCHAR AudioDriverName[WTS_DRIVER_NAME_LENGTH + 1];
WCHAR ClientName[WTS_CLIENTNAME_LENGTH + 1];
WCHAR ClientAddress[WTS_CLIENTADDRESS_LENGTH + 1];
WCHAR ClientDirectory[WTS_DIRECTORY_LENGTH + 1];
WCHAR ClientDigProductId[WTS_CLIENT_PRODUCT_ID_LENGTH + 1];
WRDS_SOCKADDR ClientSockAddress;
WRDS_TIME_ZONE_INFORMATION ClientTimeZone;
WRDS_LISTENER_SETTINGS WRdsListenerSettings;
GUID EventLogActivityId;
#if ...
ULONG ContextSize;
#if ...
PBYTE ContextData;
#else
ULONG ContextSize;
#endif
#else
PBYTE ContextData;
#endif
} WRDS_CONNECTION_SETTINGS_1, *PWRDS_CONNECTION_SETTINGS_1;
Miembros
fInheritInitialProgram
Especifica si se hereda el programa inicial que se va a iniciar en el shell de Servicios de Escritorio remoto. Este valor sobrescribe el valor del registro del agente de escucha fInheritInitialProgram .
fInheritColorDepth
Especifica si se debe heredar la profundidad del color del monitor. Este valor sobrescribe el valor del registro del agente de escucha fInheritColorDepth .
fHideTitleBar
Especifica si la barra de título está oculta.
fInheritAutoLogon
Especifica si el proceso de inicio de sesión es automático. Este valor sobrescribe el valor del registro del agente de escucha fInheritAutoLogon .
fMaximizeShell
Especifica si se muestra el programa inicial maximizado. Este valor se usa si fInheritInitialProgram está establecido en TRUE.
fDisablePNP
Especifica si el redireccionamiento de PNP está habilitado. Este valor se establece inicialmente a partir de la información de la directiva. Si restablece el valor, se sobrescribirá la directiva.
fPasswordIsScPin
Especifica que se usó una tarjeta inteligente durante el proceso de inicio de sesión. El PIN de la tarjeta inteligente es la contraseña. Este valor se usa si fInheritAutoLogon está establecido en TRUE.
fPromptForPassword
Especifica si se solicita al usuario una contraseña. Si este valor es TRUE, se le pedirá al usuario incluso si el valor del registro fInheritAutoLogon es TRUE y no se establece la directiva "Solicitar siempre una contraseña".
fDisableCpm
Especifica si la asignación de impresoras está habilitada. Este valor se establece inicialmente a partir de la información de la directiva. Si restablece el valor, se sobrescribirá la directiva.
fDisableCdm
Especifica si la asignación de unidades está habilitada. Este valor se establece inicialmente a partir de la información de la directiva. Si restablece el valor, se sobrescribirá la directiva.
fDisableCcm
Especifica si la asignación de puertos COM está habilitada. Este valor se establece inicialmente a partir de la información de la directiva. Si restablece el valor, se sobrescribirá la directiva.
fDisableLPT
Especifica si la redirección de impresora LPT está habilitada. Este valor se establece inicialmente a partir de la información de la directiva. Si restablece el valor, se sobrescribirá la directiva.
fDisableClip
Especifica si está habilitado el redireccionamiento del Portapapeles. Este valor se establece inicialmente a partir de la información de la directiva. Si restablece el valor, se sobrescribirá la directiva.
fResetBroken
Especifica la acción que el servidor realiza cuando expiran los temporizadores de conexión o de inactividad, o cuando se pierde una conexión debido a un error de conexión.
FALSE
La sesión está desconectada, pero permanece en el servidor.
TRUE
La sesión finaliza.
fDisableEncryption
Especifica si se deshabilita el cifrado para la comunicación entre el cliente y el servidor.
fDisableAutoReconnect
Especifica si se va a deshabilitar la reconexión automática del cliente.
fDisableCtrlAltDel
Especifica si el método abreviado de teclado Ctrl+Alt+Eliminar está deshabilitado.
fDoubleClickDetect
Especifica si el cliente puede hacer doble clic.
fEnableWindowsKey
Especifica si la clave de Windows está habilitada.
fUsingSavedCreds
Especifica si el cliente usa credenciales guardadas durante el proceso de inicio de sesión.
fMouse
Especifica si la entrada del mouse está habilitada.
fNoAudioPlayback
Especifica si se va a activar la reproducción de audio. Un valor de TRUE no especifica ningún audio.
fRemoteConsoleAudio
Especifica si se debe dejar la reproducción de audio en el equipo remoto.
EncryptionLevel
Especifica el nivel de cifrado.
ColorDepth
Especifica la profundidad de color del monitor de cliente. Para obtener los valores posibles, vea el miembro ColorDepth de la estructura WTS_CLIENT_DISPLAY .
ProtocolType
Especifica el tipo de protocolo.
HRes
Especifica la resolución horizontal del monitor de cliente.
VRes
Especifica la resolución vertical del monitor de cliente.
ClientProductId
Identificador de producto de software cliente.
OutBufCountHost
Número de búferes de salida en el host.
OutBufCountClient
Número de búferes de salida en el cliente.
OutBufLength
Longitud de los búferes de salida, en bytes.
KeyboardLayout
Especifica el diseño del teclado.
MaxConnectionTime
Duración máxima de la sesión de Servicios de Escritorio remoto, en minutos.
MaxDisconnectionTime
Cantidad máxima de tiempo, en minutos, que una sesión de Servicios de Escritorio remoto desconectada permanece activa en el servidor host de sesión de Escritorio remoto.
MaxIdleTime
Cantidad máxima de tiempo, en minutos, que la sesión de Servicios de Escritorio remoto puede permanecer inactiva.
PerformanceFlags
Especifica un conjunto de características que se pueden establecer en el servidor para mejorar el rendimiento. Puede ser una combinación de uno o varios de los valores siguientes.
WRDS_PERF_DISABLE_NOTHING (0x00000000)
No hay características deshabilitadas.
WRDS_PERF_DISABLE_WALLPAPER (0x00000001)
No se muestra el fondo de pantalla en el escritorio.
WRDS_PERF_DISABLE_FULLWINDOWDRAG (0x00000002)
La arrastrar ventana completa está deshabilitada; solo se muestra el esquema de la ventana cuando se mueve la ventana.
WRDS_PERF_DISABLE_MENUANIMATIONS (0x00000004)
Las animaciones de menú están deshabilitadas.
WRDS_PERF_DISABLE_THEMING (0x00000008)
Los temas están deshabilitados.
WRDS_PERF_ENABLE_ENHANCED_GRAPHICS (0x00000010)
Habilite gráficos mejorados.
WRDS_PERF_DISABLE_CURSOR_SHADOW (0x00000020)
No se muestra ninguna sombra para el cursor.
WRDS_PERF_DISABLE_CURSORSETTINGS (0x00000040)
El parpadeo del cursor está deshabilitado.
WRDS_PERF_ENABLE_FONT_SMOOTHING (0x00000080)
Habilite el suavizado de fuentes.
WRDS_PERF_ENABLE_DESKTOP_COMPOSITION (0x00000100)
Habilite la composición del escritorio.
KeyboardType
Especifica el tipo de teclado.
KeyboardSubType
Especifica el subtipo de teclado.
KeyboardFunctionKey
Especifica la clave de función.
ActiveInputLocale
Especifica el identificador de configuración regional de entrada. La palabra baja contiene un identificador de idioma y la palabra alta contiene un identificador de dispositivo para el diseño físico del teclado.
SerialNumber
Número de serie único del equipo cliente.
ClientAddressFamily
Familia de direcciones IP del cliente.
ClientBuildNumber
Número de compilación del cliente.
ClientSessionId
Identificador de sesión del cliente.
WorkDirectory[WTS_DIRECTORY_LENGTH + 1]
Cadena que contiene el directorio donde reside el programa inicial. Este valor se usa si fInheritInitialProgram está establecido en TRUE.
InitialProgram[WTS_INITIALPROGRAM_LENGTH + 1]
Valor de cadena que especifica el nombre del programa inicial. Este valor se usa si fInheritInitialProgram está establecido en TRUE.
UserName[WTS_USERNAME_LENGTH + 1]
Cadena que especifica el nombre de usuario. Este valor se usa si fInheritAutoLogon está establecido en TRUE.
Domain[WTS_DOMAIN_LENGTH + 1]
Cadena que especifica el dominio del usuario. Este valor se usa si fInheritAutoLogon está establecido en TRUE.
Password[WTS_PASSWORD_LENGTH + 1]
Cadena que especifica la contraseña de usuario. Este valor se usa si fInheritAutoLogon está establecido en TRUE.
ProtocolName[WTS_PROTOCOL_NAME_LENGTH + 1]
Cadena que contiene el nombre del protocolo.
DisplayDriverName[WTS_DRIVER_NAME_LENGTH + 1]
Cadena que especifica el nombre del controlador para mostrar que se va a cargar.
DisplayDeviceName[WTS_DEVICE_NAME_LENGTH + 1]
Cadena que especifica el nombre del dispositivo para mostrar.
imeFileName[WTS_IMEFILENAME_LENGTH + 1]
Especifica el nombre del editor del método de entrada.
AudioDriverName[WTS_DRIVER_NAME_LENGTH + 1]
Cadena que contiene el nombre del controlador de audio que se va a cargar.
ClientName[WTS_CLIENTNAME_LENGTH + 1]
Cadena que contiene el nombre completo del equipo cliente.
ClientAddress[WTS_CLIENTADDRESS_LENGTH + 1]
Cadena que contiene la dirección IP del cliente en formato decimal con puntos.
ClientDirectory[WTS_DIRECTORY_LENGTH + 1]
Directorio de cliente.
Cadena que contiene el directorio de cliente.
ClientDigProductId[WTS_CLIENT_PRODUCT_ID_LENGTH + 1]
Cadena que contiene un identificador de producto de cliente.
ClientSockAddress
Estructura WRDS_SOCKADDR que contiene información de dirección de socket.
ClientTimeZone
Estructura WRDS_TIME_ZONE_INFORMATION que contiene información de zona horaria del cliente.
WRdsListenerSettings
Estructura WRDS_LISTENER_SETTINGS que contiene la configuración del agente de escucha.
EventLogActivityId
ContextSize
Tamaño, en bytes, de la matriz ContextData .
ContextData
Matriz de bytes que contiene datos contextuales para la conexión. El tamaño de esta matriz se especifica en el miembro ContextSize .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | No se admite ninguno |
| Servidor mínimo compatible | Windows Server 2012 |
| Encabezado | wtsdefs.h (incluya Wtsprotocol.h) |