Partilhar via


Função WTSActiveSessionExists (wtsapi32.h)

Retorna se houver uma sessão ativa no sistema sem enumerar por meio da lista de sessões. Ele também não obtém nenhuma informação extra do Gerenciador de Sessão Local.

Sintaxe

BOOL WTSActiveSessionExists(
  [out] PBOOL pbActiveSessionExists
);

Parâmetros

[out] pbActiveSessionExists

Um ponteiro para um valor booliano que indica se existe uma sessão ativa.

Valor de retorno

Retornará zero se essa função falhar. Se essa função for bem-sucedida, um valor diferente de zero será retornado.

Observações

Essa função determina apenas se existe uma sessão ativa. Para obter uma lista de sessões e seus estados, use WTSEnumerateSessions. Muitos processos em execução na sessão 0 usam WTSEnumerateSessions para verificar se existe uma sessão ativa ou para fazer coisas se existe uma sessão ativa (ou seja: obter nome de usuário, ID de sessão etc. O uso de WTSEnumerateSessions quando não há sessões ativas é caro porque toda a lista de sessões inativas deve ser enumerada.

Requirements

Requirement Value
Cliente mínimo suportado Windows, versão 26100
Header wtsapi32.h