Estrutura WTSUSERCONFIGA (wtsapi32.h)
Contém informações de configuração para um usuário em um controlador de domínio ou servidor de Host de Sessão da Área de Trabalho Remota (Host de Sessão de Área de Trabalho Remota). Essa estrutura é usada pelas WTSQueryUserConfig e funções de 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
InheritInitialProgram
Um valor que indica se o cliente pode especificar o programa inicial. Esse membro pode ser um dos seguintes valores.
0
O cliente não pode especificar o programa inicial. Em vez disso, o programa especificado pela InitialProgram membro é iniciado automaticamente quando o usuário faz logon no servidor. O servidor registra o usuário desativado 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 de sessão rd. Esse membro pode ser um dos seguintes valores.
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
TimeoutSettingsDisconnections
A duração máxima, em milissegundos, que o servidor mantém uma sessão desconectada antes do logon ser encerrado. Um valor zero indica que o temporizador de desconexão está desabilitado.
TimeoutSettingsIdle
A quantidade de tempo, em milissegundos, 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
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 seguintes valores.
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 seguintes valores.
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 os temporizadores de conexão ou ocioso expiram ou quando uma conexão é perdida devido a um erro de conexão. Esse membro pode ser um dos seguintes valores.
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 seguintes valores.
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 receberá 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 seguintes valores.
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 do 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 a sessão ativamente; a permissão do usuário não é necessária.
TerminalServerRemoteHomeDir
Um valor que indica se o membro
0
O membro
1
O membro
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 de unidade seguida de dois-pontos) para a qual o caminho especificado no membro TerminalServerHomeDir é mapeado. Esse membro só é válido quando o membro TerminalServerRemoteHomeDir é definido como um.
Observações
Nota
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. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
Requisito | Valor |
---|---|
de cliente com suporte mínimo | Windows 7 |
servidor com suporte mínimo | Windows Server 2008 R2 |
cabeçalho | wtsapi32.h |