Estrutura WTSUSERCONFIGA (wtsapi32.h)
Contém informações de configuração para um usuário em um controlador de domínio ou servidor host da sessão da Área de Trabalho Remota (Host da Sessão da Área de Trabalho Remota). Essa estrutura é usada pelas funções WTSQueryUserConfig e WTSSetUserConfig .
Sintaxe
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;
Membros
Source
Um valor do tipo de enumeração WTS_CONFIG_SOURCE que especifica a origem das informações de configuração retornadas pela função WTSQueryUserConfig .
InheritInitialProgram
Um valor que indica se o cliente pode especificar o programa inicial. Esse membro pode ser um dos valores a seguir.
0
O cliente não pode especificar o programa inicial. Em vez disso, o programa especificado pelo membro InitialProgram é iniciado automaticamente quando o usuário faz logon no servidor. O servidor faz logoff do usuário quando o usuário sai do programa.
1
O cliente pode especificar o programa inicial.
AllowLogonTerminalServer
Um valor que indica se a conta de usuário tem permissão para fazer logon em um servidor Host da Sessão da Área de Trabalho Remota. Esse membro pode ser um dos valores a seguir.
0
O usuário não pode fazer logon.
1
O usuário pode fazer logon.
TimeoutSettingsConnections
A duração máxima da conexão, em milissegundos. Um minuto antes da conexão expirar, o servidor notifica o usuário sobre a desconexão pendente. Quando a conexão atinge o tempo limite, o servidor executa a ação especificada pelo membro BrokenTimeoutSettings . Sempre que o usuário faz logon, o temporizador é redefinido. Um valor zero indica que o temporizador de conexão está desabilitado.
TimeoutSettingsDisconnections
A duração máxima, em milissegundos, de que o servidor retém uma sessão desconectada antes que o logon seja encerrado. Um valor zero indica que o temporizador de desconexão está desabilitado.
TimeoutSettingsIdle
A quantidade de tempo, em milissegundos, em que uma conexão pode permanecer ociosa. Se não houver nenhuma atividade de teclado ou mouse para esse período de tempo, o servidor executará a ação especificada pelo membro BrokenTimeoutSettings . Um valor zero indica que o temporizador ocioso está desabilitado.
DeviceClientDrives
Este membro é reservado.
DeviceClientPrinters
Um valor que indica se o servidor se conecta automaticamente a impressoras cliente mapeadas anteriormente quando o usuário faz logon no servidor. Esse membro pode ser um dos valores a seguir.
0
O servidor não se conecta automaticamente a impressoras cliente mapeadas anteriormente.
1
O servidor se conecta automaticamente a impressoras cliente mapeadas anteriormente.
ClientDefaultPrinter
Um valor que indica se a impressora cliente é a impressora padrão. Esse membro pode ser um dos valores a seguir.
0
A impressora cliente não é a impressora padrão.
1
A impressora cliente é a impressora padrão.
BrokenTimeoutSettings
A ação que o servidor executa quando a conexão ou os temporizadores ociosos expiram ou quando uma conexão é perdida devido a um erro de conexão. Esse membro pode ser um dos valores a seguir.
0
A sessão está desconectada, mas permanece no servidor.
1
A sessão é encerrada.
ReconnectSettings
Um valor que indica como uma sessão desconectada para esse usuário pode ser reconectada. Esse membro pode ser um dos valores a seguir.
0
O usuário pode fazer logon em qualquer computador cliente para se reconectar a uma sessão desconectada.
1
O usuário deve fazer logon no computador cliente originalmente usado para estabelecer a sessão desconectada. Se o usuário fizer logon em um computador cliente diferente, o usuário obterá uma nova sessão.
ShadowingSettings
A configuração de controle remoto. O controle remoto permite que um usuário monitore remotamente as operações na tela de outro usuário. Esse membro pode ser um dos valores a seguir.
0
O controle remoto está desabilitado.
1
O usuário de controle remoto tem controle total da sessão do usuário, com a permissão do usuário.
2
O usuário de controle remoto tem controle total da sessão do usuário; a permissão do usuário não é necessária.
3
O usuário do controle remoto pode exibir a sessão remotamente, com a permissão do usuário; o usuário remoto não pode controlar ativamente a sessão.
4
O usuário do controle remoto pode exibir a sessão remotamente, mas não controlar ativamente a sessão; a permissão do usuário não é necessária.
TerminalServerRemoteHomeDir
Um valor que indica se o membro TerminalServerHomeDir contém um caminho para um diretório local ou um compartilhamento de rede. Não é possível definir esse membro usando a função WTSSetUserConfig . Esse membro pode ser um dos valores a seguir.
0
O membro TerminalServerHomeDir contém um caminho para um diretório local.
1
O membro TerminalServerHomeDir contém um caminho para um compartilhamento de rede e o membro TerminalServerHomeDirDrive contém uma letra da unidade para a qual esse caminho é mapeado.
InitialProgram[MAX_PATH + 1]
Uma cadeia de caracteres terminada em nulo que contém o nome do programa a ser iniciado imediatamente após o usuário fazer logon no servidor.
WorkDirectory[MAX_PATH + 1]
Uma cadeia de caracteres terminada em nulo que contém o caminho do diretório de trabalho para o programa inicial.
TerminalServerProfilePath[MAX_PATH + 1]
Uma cadeia de caracteres terminada em nulo que contém o caminho do perfil atribuído ao usuário quando o usuário se conecta ao servidor. O diretório especificado pelo caminho deve ser criado manualmente e deve existir antes do logon.
TerminalServerHomeDir[MAX_PATH + 1]
Uma cadeia de caracteres terminada em nulo que contém o caminho para a pasta inicial das sessões dos Serviços de Área de Trabalho Remota do usuário. A pasta pode ser uma pasta local ou um compartilhamento de rede.
TerminalServerHomeDirDrive[WTS_DRIVE_LENGTH + 1]
Uma cadeia de caracteres terminada em nulo que contém o nome da unidade (uma letra da unidade seguida por dois-pontos) para o qual o caminho especificado no membro TerminalServerHomeDir é mapeado. Esse membro só é válido quando o membro TerminalServerRemoteHomeDir é definido como um.
Comentários
Observação
O cabeçalho wtsapi32.h define WTSUSERCONFIG como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Cliente mínimo com suporte | Windows 7 |
| Servidor mínimo com suporte | Windows Server 2008 R2 |
| Cabeçalho | wtsapi32.h |
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de