enumeración WTS_CONFIG_CLASS (wtsapi32.h)

Artículo
03/13/2024

Contiene valores que indican el tipo de información de configuración de usuario que se va a establecer o recuperar en una llamada a las funciones WTSQueryUserConfig y WTSSetUserConfig .

Syntax

typedef enum _WTS_CONFIG_CLASS {
  WTSUserConfigInitialProgram,
  WTSUserConfigWorkingDirectory,
  WTSUserConfigfInheritInitialProgram,
  WTSUserConfigfAllowLogonTerminalServer,
  WTSUserConfigTimeoutSettingsConnections,
  WTSUserConfigTimeoutSettingsDisconnections,
  WTSUserConfigTimeoutSettingsIdle,
  WTSUserConfigfDeviceClientDrives,
  WTSUserConfigfDeviceClientPrinters,
  WTSUserConfigfDeviceClientDefaultPrinter,
  WTSUserConfigBrokenTimeoutSettings,
  WTSUserConfigReconnectSettings,
  WTSUserConfigModemCallbackSettings,
  WTSUserConfigModemCallbackPhoneNumber,
  WTSUserConfigShadowingSettings,
  WTSUserConfigTerminalServerProfilePath,
  WTSUserConfigTerminalServerHomeDir,
  WTSUserConfigTerminalServerHomeDirDrive,
  WTSUserConfigfTerminalServerRemoteHomeDir,
  WTSUserConfigUser
} WTS_CONFIG_CLASS;

Constantes

WTSUserConfigInitialProgram
Cadena terminada en NULL que contiene la ruta de acceso del programa inicial que servicios de Escritorio remoto se ejecuta cuando el
el usuario inicia sesión.

Si el valor WTSUserConfigfInheritInitialProgram es 1, el programa inicial puede ser
cualquier programa especificado por el cliente.

WTSUserConfigWorkingDirectory
Cadena terminada en null que contiene la ruta de acceso del directorio de trabajo para el programa inicial.

WTSUserConfigfInheritInitialProgram
Valor que indica si el cliente puede especificar el programa inicial.

Valor	Significado
0	El cliente no puede especificar el programa inicial. En su lugar, La cadena WTSUserConfigInitialProgram identifica un programa inicial que se ejecuta automáticamente cuando el usuario inicia sesión en un equipo remoto. Servicios de Escritorio remoto cierra el usuario cuando el usuario sale de ese programa.
1	El cliente puede especificar el programa inicial.

WTSUserConfigfAllowLogonTerminalServer
Valor que indica si la cuenta de usuario puede iniciar sesión en un servidor host de sesión de Escritorio remoto.

Valor	Significado
0	El usuario no puede iniciar sesión.
1	El usuario puede iniciar sesión.

WTSUserConfigTimeoutSettingsConnections
Valor DWORD que especifica la duración máxima de la conexión, en milisegundos.
Un minuto antes de que expire el intervalo de tiempo de espera de conexión, se notifica al usuario la desconexión pendiente.
La sesión del usuario se desconecta o finaliza en función de la
Valor WTSUserConfigBrokenTimeoutSettings . Cada vez que el usuario inicia sesión, el temporizador es
Restablecer. Un valor de cero indica que el temporizador de conexión está deshabilitado.

WTSUserConfigTimeoutSettingsDisconnections
Valor DWORD que especifica la duración máxima, en milisegundos, que es
El servidor host de sesión de Escritorio remoto 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.

WTSUserConfigTimeoutSettingsIdle
Valor DWORD que especifica el tiempo de inactividad máximo, en milisegundos. Si hay
no es ninguna actividad de teclado o mouse para el intervalo especificado, la sesión del usuario se desconecta o finaliza.
según el valor WTSUserConfigBrokenTimeoutSettings . Valor de cero
indica que el temporizador de inactividad está deshabilitado.

WTSUserConfigfDeviceClientDrives
Actualmente, los Servicios de Escritorio remoto no usan esta constante.

Valor que indica si el servidor host de sesión de Escritorio remoto se restablece automáticamente.
asignaciones de unidades de cliente en el inicio de sesión.

Valor	Significado
0	El servidor no se conecta automáticamente a unidades de cliente asignadas previamente.
1	El servidor se conecta automáticamente a unidades de cliente asignadas previamente en el inicio de sesión.

WTSUserConfigfDeviceClientPrinters
RDP 5.0 y clientes posteriores: valor que indica si el servidor host de sesión de Escritorio remoto
restablece automáticamente las asignaciones de impresora de cliente en el inicio de sesión.

Valor	Significado
0	El servidor no se conecta automáticamente a impresoras cliente asignadas previamente.
1	El servidor se conecta automáticamente a impresoras cliente asignadas previamente en el inicio de sesión.

WTSUserConfigfDeviceClientDefaultPrinter
RDP 5.0 y clientes posteriores: valor que indica si la impresora cliente
es la impresora predeterminada.

Valor	Significado
0	La impresora cliente no es la impresora predeterminada.
1	La impresora cliente es la impresora predeterminada.

WTSUserConfigBrokenTimeoutSettings
Valor que indica lo que sucede cuando expiran los temporizadores de conexión o de inactividad o cuando se pierde una conexión.
debido a un error de conexión.

Valor	Significado
0	La sesión está desconectada.
1	La sesión finaliza.

WTSUserConfigReconnectSettings
Valor que indica cómo se puede volver a conectar una sesión desconectada para este usuario.

Valor	Significado
0	El usuario puede iniciar sesión en cualquier equipo cliente para volver a conectarse a una sesión desconectada.
1	El usuario puede volver a conectarse a una sesión desconectada iniciando sesión en el equipo cliente que se usa para establecer la sesión desconectada. Si el usuario inicia sesión desde un equipo cliente diferente, el usuario obtiene un nuevo inicio de sesión. Sesión.

WTSUserConfigModemCallbackSettings
Actualmente, los Servicios de Escritorio remoto no usan esta constante.

Valor que indica la configuración de las conexiones de acceso telefónico en las que
El servidor host de sesión de Escritorio remoto deja de responder y, a continuación, llama al cliente para establecer la conexión.

Valor	Significado
0	Las conexiones de devolución de llamada están deshabilitadas.
1	El servidor solicita al usuario que escriba un número de teléfono y vuelva a llamar al usuario en ese número de teléfono. Puede use el valor WTSUserConfigModemCallbackPhoneNumber para especificar un teléfono predeterminado. .
2	El servidor llama automáticamente al usuario en el número de teléfono especificado por . Valor WTSUserConfigModemCallbackPhoneNumber .

WTSUserConfigModemCallbackPhoneNumber
Actualmente, los Servicios de Escritorio remoto no usan esta constante.

Cadena terminada en null que contiene el número de teléfono que se va a usar para la devolución de llamada.
seguras.

WTSUserConfigShadowingSettings
RDP 5.0 y clientes posteriores: valor que indica si la sesión del usuario
se puede sombrear. Shadowing permite a un usuario supervisar de forma remota las operaciones en pantalla de otro usuario.

Valor	Significado
0	Deshabilitar
1	Habilitación de la entrada, notificación
2	Habilitación de la entrada, sin notificación
3	Habilitar sin entrada, notificar
4	Habilitar sin entrada, sin notificación

WTSUserConfigTerminalServerProfilePath
Cadena terminada en null que contiene la ruta de acceso del perfil del usuario para el inicio de sesión del servidor host de sesión de Escritorio remoto. El directorio
La ruta de acceso identifica debe crearse manualmente y debe existir antes del inicio de sesión.
WTSSetUserConfig no creará el directorio
si aún no existe.

WTSUserConfigTerminalServerHomeDir
Cadena terminada en NULL que contiene la ruta de acceso del directorio raíz del usuario para el inicio de sesión del servidor host de sesión de Escritorio remoto. Este
string puede especificar una ruta de acceso local o una ruta de acceso UNC (\ComputerName\Share\Path). Para obtener más información, vea
WTSUserConfigfTerminalServerRemoteHomeDir.

WTSUserConfigTerminalServerHomeDirDrive
Cadena terminada en NULL que contiene un nombre de unidad (una letra de unidad seguida de dos puntos) a la que el UNC
ruta de acceso especificada en la cadena WTSUserConfigTerminalServerHomeDir está asignada. Para obtener más información, vea
WTSUserConfigfTerminalServerRemoteHomeDir.

WTSUserConfigfTerminalServerRemoteHomeDir
Valor que indica si el directorio raíz del usuario para el inicio de sesión del servidor host de sesión de Escritorio remoto es una ruta de acceso local o un
letra de unidad asignada. Tenga en cuenta que este valor no se puede usar con
WTSSetUserConfig.

Valor	Significado
0	La cadena WTSUserConfigTerminalServerHomeDir contiene la ruta de acceso local del Directorio raíz de inicio de sesión del servidor host de sesión de Escritorio remoto del usuario.
1	La cadena WTSUserConfigTerminalServerHomeDir contiene la ruta de acceso UNC del Directorio raíz de inicio de sesión del servidor host de sesión de Escritorio remoto del usuario y La cadena WTSUserConfigTerminalServerHomeDirDrive contiene una letra de unidad a la que se asigna la ruta de acceso UNC.

WTSUserConfigUser
Estructura WTSUSERCONFIG que contiene datos de configuración para la sesión.

Windows Server 2008 y Windows Vista: Este valor no se admite.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Encabezado	wtsapi32.h

Consulte también

WTSQueryUserConfig

WTSSetUserConfig