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 se usa en 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
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 el 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 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 impresoras cliente asignadas previamente.
1
El servidor se conecta automáticamente a 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 toma el servidor cuando expiran los temporizadores de conexión o 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 otro equipo cliente, 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; 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.
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
0
El miembro
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 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 |