Compartilhar via


Função WTSQueryUserToken (wtsapi32.h)

Obtém o token de acesso primário do usuário conectado especificado pela ID da sessão. Para chamar essa função com êxito, o aplicativo de chamada deve estar em execução no contexto da conta LocalSystem e ter o privilégio SE_TCB_NAME .

Cuidado O WTSQueryUserTokendestina-se a serviços altamente confiáveis. Os provedores de serviços devem ter cuidado para não vazar tokens de usuário ao chamar essa função. Os provedores de serviços devem fechar identificadores de token depois de terminarem de usá-los.
 

Sintaxe

BOOL WTSQueryUserToken(
  [in]  ULONG   SessionId,
  [out] PHANDLE phToken
);

Parâmetros

[in] SessionId

Um identificador de sessão dos Serviços de Área de Trabalho Remota. Qualquer programa em execução no contexto de um serviço terá um identificador de sessão igual a zero (0). Você pode usar a função WTSEnumerateSessions para recuperar os identificadores de todas as sessões em um servidor host de sessão rd especificado.

Para poder consultar informações para a sessão de outro usuário, você precisa ter a permissão Informações de Consulta. 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.

[out] phToken

Se a função for bem-sucedida, receberá um ponteiro para o identificador de token para o usuário conectado. Observe que você deve chamar a função CloseHandle para fechar esse identificador.

Valor retornado

Se a função for bem-sucedida, o valor retornado será um valor diferente de zero e o parâmetro phToken apontará para o token primário do usuário.

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

Comentários

Para obter informações sobre tokens primários, consulte Tokens de acesso. Para obter mais informações sobre privilégios de conta, consulte Permissões e constantes de autorização dos Serviços de Área de Trabalho Remota.

Consulte Conta localSystem para obter informações sobre os privilégios associados a essa conta.

Requisitos

   
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 no Windows 8)

Confira também

CloseHandle

WTSEnumerateSessions