Função WTSDisconnectSession (wtsapi32.h)

Artigo
03/04/2024

Desconecta o usuário conectado da sessão dos Serviços de Área de Trabalho Remota especificada sem fechar a sessão. Se o usuário fizer logon posteriormente no mesmo servidor host de sessão de área de trabalho remota (Host de Sessão de Área de Trabalho Remota), o usuário será reconectado à mesma sessão.

Sintaxe

BOOL WTSDisconnectSession(
  [in] HANDLE hServer,
  [in] DWORD  SessionId,
  [in] BOOL   bWait
);

Parâmetros

[in] hServer

Um identificador para um servidor host de sessão de área de trabalho remota. Especifique um identificador aberto pela função WTSOpenServer ou WTSOpenServerEx ou especifique WTS_CURRENT_SERVER_HANDLE para indicar o servidor host da sessão rd no qual seu aplicativo está em execução.

[in] SessionId

Um identificador de sessão dos Serviços de Área de Trabalho Remota. Para indicar a sessão atual, especifique WTS_CURRENT_SESSION. Para recuperar os identificadores de todas as sessões em um servidor host de sessão rd especificado, use a função WTSEnumerateSessions .

Para poder desconectar a sessão de outro usuário, você precisa ter a permissão Desconectar. Para obter mais informações, consulte Permissões dos Serviços de Área de Trabalho Remota. Para modificar permissões em uma sessão, use a ferramenta administrativa Configuração de Serviços de Área de Trabalho Remota.

Para desconectar sessões em execução em uma máquina virtual hospedada em um servidor Host de Virtualização de Área de Trabalho Remota, você deve ser membro do grupo Administradores no servidor host de virtualização de área de trabalho remota.

[in] bWait

Indica se a operação é síncrona. Especifique TRUE para aguardar a conclusão da operação ou FALSE retornar imediatamente.

Retornar valor

Se a função for bem-sucedida, o valor retornado será um valor diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	wtsapi32.h
Biblioteca	Wtsapi32.lib
DLL	Wtsapi32.dll
Conjunto de APIs	ext-ms-win-session-wtsapi32-l1-1-0 (introduzido em Windows 8)

Confira também

WTSEnumerateSessions

Compartilhar via