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 .
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) |