Compartir a través de


Estructura WTSUSERCONFIGA (wtsapi32.h)

Contiene información de configuración para un usuario en un controlador de dominio o en un servidor host de sesión de Escritorio remoto (host de sesión de Escritorio remoto). Esta estructura la usan las funciones WTSQueryUserConfig y WTSSetUserConfig .

Sintaxis

typedef struct _WTSUSERCONFIGA {
  DWORD Source;
  DWORD InheritInitialProgram;
  DWORD AllowLogonTerminalServer;
  DWORD TimeoutSettingsConnections;
  DWORD TimeoutSettingsDisconnections;
  DWORD TimeoutSettingsIdle;
  DWORD DeviceClientDrives;
  DWORD DeviceClientPrinters;
  DWORD ClientDefaultPrinter;
  DWORD BrokenTimeoutSettings;
  DWORD ReconnectSettings;
  DWORD ShadowingSettings;
  DWORD TerminalServerRemoteHomeDir;
  CHAR  InitialProgram[MAX_PATH + 1];
  CHAR  WorkDirectory[MAX_PATH + 1];
  CHAR  TerminalServerProfilePath[MAX_PATH + 1];
  CHAR  TerminalServerHomeDir[MAX_PATH + 1];
  CHAR  TerminalServerHomeDirDrive[WTS_DRIVE_LENGTH + 1];
} WTSUSERCONFIGA, *PWTSUSERCONFIGA;

Miembros

Source

Valor del tipo de enumeración WTS_CONFIG_SOURCE que especifica el origen de la información de configuración devuelta por la función WTSQueryUserConfig .

InheritInitialProgram

Valor que indica si el cliente puede especificar el programa inicial. Este miembro puede ser uno de los siguientes valores.

0

El cliente no puede especificar el programa inicial. En su lugar, el programa especificado por el miembro InitialProgram se inicia automáticamente cuando el usuario inicia sesión en el servidor. El servidor cierra la sesión del usuario cuando el usuario sale de ese programa.

1

El cliente puede especificar el programa inicial.

AllowLogonTerminalServer

Valor que indica si la cuenta de usuario puede iniciar sesión en un servidor host de sesión de Escritorio remoto. Este miembro puede ser uno de los siguientes valores.

0

El usuario no puede iniciar sesión.

1

El usuario puede iniciar sesión.

TimeoutSettingsConnections

Duración máxima de la conexión, en milisegundos. Un minuto antes de que expire la conexión, el servidor notifica al usuario sobre la desconexión pendiente. Cuando se agota el tiempo de espera de la conexión, el servidor realiza la acción especificada por el miembro BrokenTimeoutSettings . 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.

TimeoutSettingsDisconnections

La duración máxima, en milisegundos, que el 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

Cantidad de tiempo, en milisegundos, que una conexión puede permanecer inactiva. Si no hay ninguna actividad de teclado o mouse durante este período de tiempo, el servidor realiza la acción especificada por el miembro BrokenTimeoutSettings . Un valor de cero indica que el temporizador de inactividad está deshabilitado.

DeviceClientDrives

Este miembro está reservado.

DeviceClientPrinters

Valor que indica si el servidor se conecta automáticamente a impresoras cliente asignadas previamente cuando el usuario inicia sesión en el servidor. Este miembro puede ser uno de los siguientes valores.

0

El servidor no se conecta automáticamente a las impresoras cliente asignadas previamente.

1

El servidor se conecta automáticamente a las impresoras cliente asignadas previamente.

ClientDefaultPrinter

Valor que indica 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.

BrokenTimeoutSettings

La acción que el servidor realiza cuando expiran las conexiones o los temporizadores de inactividad, o cuando se pierde una conexión debido a un error de conexión. Este miembro puede ser uno de los siguientes valores.

0

La sesión está desconectada, pero permanece en el servidor.

1

La sesión finaliza.

ReconnectSettings

Valor que indica cómo se puede volver a conectar una sesión desconectada para este usuario. Este miembro puede ser uno de los siguientes valores.

0

El usuario puede iniciar sesión en cualquier equipo cliente para volver a conectarse a una sesión desconectada.

1

El usuario debe iniciar sesión en el equipo cliente que se usó originalmente para establecer la sesión desconectada. Si el usuario inicia sesión en un equipo cliente diferente, el usuario obtiene una nueva sesión.

ShadowingSettings

Configuración del control remoto. El control remoto permite a un usuario supervisar de forma remota las operaciones en pantalla de otro usuario. 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; 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.

TerminalServerRemoteHomeDir

Valor que indica si el miembro TerminalServerHomeDir contiene una ruta de acceso a un directorio local o a un recurso compartido de red. No puede establecer este miembro mediante la función WTSSetUserConfig . Este miembro puede ser uno de los siguientes valores.

0

El miembro TerminalServerHomeDir contiene una ruta de acceso a un directorio local.

1

El miembro TerminalServerHomeDir contiene una ruta de acceso a un recurso compartido de red y el miembro TerminalServerHomeDirDrive contiene una letra de unidad a la que se asigna esta ruta de acceso.

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.

WorkDirectory[MAX_PATH + 1]

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

TerminalServerProfilePath[MAX_PATH + 1]

Cadena terminada en null que contiene la ruta de acceso del perfil que se asigna al usuario cuando el usuario se conecta al servidor. El directorio especificado por la ruta de acceso debe crearse manualmente y debe existir antes del inicio de sesión.

TerminalServerHomeDir[MAX_PATH + 1]

Cadena terminada en null que contiene la ruta de acceso a la carpeta principal de las sesiones de Servicios de Escritorio remoto del usuario. La carpeta puede ser una carpeta local o un recurso compartido de red.

TerminalServerHomeDirDrive[WTS_DRIVE_LENGTH + 1]

Cadena terminada en null que contiene el nombre de unidad (una letra de unidad seguida de dos puntos) a la que se asigna la ruta de acceso especificada en el miembro TerminalServerHomeDir . Este miembro solo es válido cuando el miembro TerminalServerRemoteHomeDir está establecido en uno.

Observaciones

Nota

El encabezado wtsapi32.h define WTSUSERCONFIG 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

   
Cliente mínimo compatible Windows 7
Servidor mínimo compatible Windows Server 2008 R2
Encabezado wtsapi32.h

Consulte también

WTSQueryUserConfig

WTSSetUserConfig

WTS_CONFIG_SOURCE