Função WTSQuerySessionInformationA (wtsapi32.h)
Recupera informações de sessão para a sessão especificada no servidor do Host da Sessão da Área de Trabalho Remota (Host da Sessão da Área de Trabalho Remota) especificado. Ele pode ser usado para consultar informações de sessão em servidores host de sessão de Área de Trabalho Remota locais e remotos.
Sintaxe
BOOL WTSQuerySessionInformationA(
[in] HANDLE hServer,
[in] DWORD SessionId,
[in] WTS_INFO_CLASS WTSInfoClass,
[out] LPSTR *ppBuffer,
[out] DWORD *pBytesReturned
);
Parâmetros
[in] hServer
Um identificador para um servidor Host da Sessão de Área de Trabalho Remota. Especifique um identificador aberto pela função WTSOpenServer ou especifique WTS_CURRENT_SERVER_HANDLE para indicar o servidor Host da Sessão de Área de Trabalho Remota no qual o aplicativo está sendo executado.
[in] SessionId
Um identificador de sessão dos Serviços de Área de Trabalho Remota. Para indicar a sessão na qual o aplicativo de chamada está em execução (ou a sessão atual) especifique WTS_CURRENT_SESSION. Especifique apenas WTS_CURRENT_SESSION ao obter informações de sessão no servidor local. Se WTS_CURRENT_SESSION for especificado ao consultar informações de sessão em um servidor remoto, as informações de sessão retornadas serão inconsistentes. Não use os dados retornados.
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 consultar informações sobre a sessão de outro usuário, você deve 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.
[in] WTSInfoClass
Um valor da enumeração WTS_INFO_CLASS que indica o tipo de informações de sessão a serem recuperadas em uma chamada para a função WTSQuerySessionInformation .
[out] ppBuffer
Um ponteiro para uma variável que recebe um ponteiro para as informações solicitadas. O formato e o conteúdo dos dados dependem da classe de informações especificada no parâmetro WTSInfoClass . Para liberar o buffer retornado, chame a função WTSFreeMemory .
[out] pBytesReturned
Um ponteiro para uma variável que recebe o tamanho, em bytes, dos dados retornados no ppBuffer.
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.
Comentários
Para recuperar a ID da sessão atual quando os Serviços de Área de Trabalho Remota estiverem em execução, chame WTSQuerySessionInformation e especifiqueWTS_CURRENT_SESSION para o parâmetro SessionId e WTSSessionId para o parâmetro WTSInfoClass . A ID da sessão será retornada no parâmetro ppBuffer . Se os Serviços de Área de Trabalho Remota não estiverem em execução, as chamadas para WTSQuerySessionInformation falharão. Nessa situação, você pode recuperar a ID da sessão atual chamando a função ProcessIdToSessionId .
Para determinar se o aplicativo está em execução no console físico, você deve especificar WTS_CURRENT_SESSION para o parâmetro SessionId e WTSClientProtocolType como o parâmetro WTSInfoClass . Se ppBuffer for "0", a sessão será anexada ao console físico.
Observação
O cabeçalho wtsapi32.h define WTSQuerySessionInformation como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
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 no Windows 8) |