Estrutura WTSLISTENERCONFIGA (wtsapi32.h)
Contém informações sobre um ouvinte dos Serviços de Área de Trabalho Remota. Essa estrutura é usada pela função
Sintaxe
typedef struct _WTSLISTENERCONFIGA {
ULONG version;
ULONG fEnableListener;
ULONG MaxConnectionCount;
ULONG fPromptForPassword;
ULONG fInheritColorDepth;
ULONG ColorDepth;
ULONG fInheritBrokenTimeoutSettings;
ULONG BrokenTimeoutSettings;
ULONG fDisablePrinterRedirection;
ULONG fDisableDriveRedirection;
ULONG fDisableComPortRedirection;
ULONG fDisableLPTPortRedirection;
ULONG fDisableClipboardRedirection;
ULONG fDisableAudioRedirection;
ULONG fDisablePNPRedirection;
ULONG fDisableDefaultMainClientPrinter;
ULONG LanAdapter;
ULONG PortNumber;
ULONG fInheritShadowSettings;
ULONG ShadowSettings;
ULONG TimeoutSettingsConnection;
ULONG TimeoutSettingsDisconnection;
ULONG TimeoutSettingsIdle;
ULONG SecurityLayer;
ULONG MinEncryptionLevel;
ULONG UserAuthentication;
CHAR Comment[WTS_COMMENT_LENGTH + 1];
CHAR LogonUserName[USERNAME_LENGTH + 1];
CHAR LogonDomain[DOMAIN_LENGTH + 1];
CHAR WorkDirectory[MAX_PATH + 1];
CHAR InitialProgram[MAX_PATH + 1];
} WTSLISTENERCONFIGA, *PWTSLISTENERCONFIGA;
Membros
version
Este membro é reservado.
fEnableListener
Especifica se o ouvinte está habilitado. Esse membro pode ser um dos seguintes valores.
0
O ouvinte está desabilitado.
1
O ouvinte está habilitado.
MaxConnectionCount
O número máximo de conexões ativas aceitas pelo ouvinte.
fPromptForPassword
Especifica se o ouvinte sempre solicita ao usuário uma senha. Esse membro pode ser um dos seguintes valores.
0
Solicite ao usuário uma senha somente quando especificado pelo servidor.
1
Sempre solicite uma senha ao usuário.
fInheritColorDepth
Especifica se o ouvinte deve usar a profundidade de cor especificada pelo usuário. Esse membro pode ser um dos seguintes valores.
0
Use a profundidade de cor especificada pelo servidor.
1
Use a profundidade de cor especificada pelo usuário.
ColorDepth
A configuração de profundidade de cor para o ouvinte. Essa configuração só se aplica quando o membro fInheritColorDepth é zero. Esse pode ser um dos valores a seguir.
1
8 bits
2
15 bits
3
16 bits
4
24 bits
5
32 bits
fInheritBrokenTimeoutSettings
Especifica se o ouvinte deve usar o BrokenTimeoutSettings valor especificado pelo usuário. Esse membro pode ser um dos seguintes valores.
0
Use o valor
1
Use o valor
BrokenTimeoutSettings
A ação que o ouvinte executa quando uma conexão ou temporizador ocioso expira ou quando uma conexão é perdida devido a um erro de conexão. Essa configuração só se aplica quando o membro
0
Quando uma conexão ou temporizador ocioso expira ou quando uma conexão é perdida devido a um erro de conexão, o usuário é desconectado, mas a sessão permanece no servidor.
1
Quando uma conexão ou temporizador ocioso expira ou quando uma conexão é perdida devido a um erro de conexão, a sessão é encerrada.
fDisablePrinterRedirection
Especifica se o redirecionamento da impressora está desabilitado. Esse membro pode ser um dos seguintes valores.
0
O usuário pode habilitar o redirecionamento da impressora.
1
O redirecionamento da impressora está desabilitado.
fDisableDriveRedirection
Especifica se o redirecionamento da unidade está desabilitado. Esse membro pode ser um dos seguintes valores.
0
O usuário pode habilitar o redirecionamento da unidade.
1
O redirecionamento da unidade está desabilitado.
fDisableComPortRedirection
Especifica se o redirecionamento de porta COM está desabilitado. Esse membro pode ser um dos seguintes valores.
0
O usuário pode habilitar o redirecionamento de porta COM.
1
O redirecionamento de porta COM está desabilitado.
fDisableLPTPortRedirection
Especifica se o redirecionamento de porta LPT está desabilitado. Esse membro pode ser um dos seguintes valores.
0
O usuário pode habilitar o redirecionamento de porta LPT.
1
O redirecionamento de porta LPT está desabilitado.
fDisableClipboardRedirection
Especifica se o redirecionamento da área de transferência está desabilitado. Esse membro pode ser um dos seguintes valores.
0
O usuário pode habilitar o redirecionamento da área de transferência.
1
O redirecionamento da área de transferência está desabilitado.
fDisableAudioRedirection
Especifica se o redirecionamento de áudio está desabilitado. Esse membro pode ser um dos seguintes valores.
0
O usuário pode habilitar o redirecionamento de áudio.
1
O redirecionamento de áudio está desabilitado.
fDisablePNPRedirection
Especifica se o redirecionamento do Plug and Play está desabilitado. Esse membro pode ser um dos seguintes valores.
0
O usuário pode habilitar o redirecionamento do Plug and Play.
1
O redirecionamento do Plug and Play está desabilitado.
fDisableDefaultMainClientPrinter
Especifica 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.
LanAdapter
O adaptador de rede que o ouvinte usa.
PortNumber
O número da porta do ouvinte.
fInheritShadowSettings
Especifica se o ouvinte deve usar o ShadowSettings valor especificado pelo usuário. Esse membro pode ser um dos seguintes valores.
0
Use a configuração especificada pelo servidor.
1
Use a configuração especificada pelo usuário.
ShadowSettings
A configuração de controle remoto para o ouvinte. O controle remoto permite que um usuário monitore remotamente as operações na tela de outro usuário. Essa configuração só se aplica quando o membro fInheritShadowSettings é zero. 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.
TimeoutSettingsConnection
A duração máxima da conexão, em milissegundos. Sempre que o usuário faz logon, o temporizador é redefinido. Um valor zero indica que o temporizador de conexão está desabilitado.
TimeoutSettingsDisconnection
A duração máxima, em milissegundos, que um 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
O tempo máximo de ociosidade, em milissegundos. Um valor zero indica que o temporizador ocioso está desabilitado.
SecurityLayer
A camada de segurança do ouvinte. Esse membro pode ser um dos seguintes valores.
0
O RDP (Protocolo de Área de Trabalho Remota) é usado pelo servidor e pelo cliente para autenticação antes de uma conexão ser estabelecida.
1
O servidor e o cliente negociam o método de autenticação antes que uma conexão seja estabelecida.
2
O protocolo TLS (Transport Layer Security) é usado pelo servidor e pelo cliente para autenticação antes de uma conexão ser estabelecida.
MinEncryptionLevel
Nível de criptografia do ouvinte. Esse membro pode ser um dos seguintes valores.
1
Os dados enviados do cliente para o servidor são criptografados usando criptografia de 56 bits. Os dados enviados do servidor para o cliente não são criptografados.
2
Todos os dados enviados do cliente para o servidor e do servidor para o cliente são criptografados usando a força máxima de chave compatível com o cliente.
3
Todos os dados enviados do cliente para o servidor e do servidor para o cliente são criptografados usando criptografia de 128 bits. Os clientes que não dão suporte a esse nível de criptografia não podem se conectar.
4
Todos os dados enviados do cliente para o servidor e do servidor para o cliente são criptografados e descriptografados usando os algoritmos de criptografia FIPS (Federal Information Processing Standards) e módulos criptográficos da Microsoft.
UserAuthentication
Especifica se a autenticação de usuário no nível da rede é necessária antes que a conexão seja estabelecida. Esse membro pode ser um dos seguintes valores.
0
A autenticação de usuário no nível da rede não é necessária.
1
A autenticação de usuário no nível da rede é necessária.
Comment[WTS_COMMENT_LENGTH + 1]
Uma cadeia de caracteres terminada em nulo que contém uma descrição do ouvinte.
LogonUserName[USERNAME_LENGTH + 1]
Uma cadeia de caracteres terminada em nulo que contém o nome de usuário usado em cenários de logon automático.
LogonDomain[DOMAIN_LENGTH + 1]
Uma cadeia de caracteres terminada em nulo que contém o nome de domínio usado em cenários de logon automático.
WorkDirectory[MAX_PATH + 1]
Uma cadeia de caracteres terminada em nulo que contém o caminho do diretório de trabalho do programa inicial.
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.
Observações
Nota
O cabeçalho wtsapi32.h define WTSLISTENERCONFIG 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 |