Função WTSEnumerateProcessesExA (wtsapi32.h)

  • Artigo

Recupera informações sobre os processos ativos no servidor do Host de Sessão de Área de Trabalho Remota (Host de Sessão de Área de Trabalho Remota) especificado ou no servidor do Host de Virtualização de Área de Trabalho Remota (Host de Virtualização de Área de Trabalho Remota).

Sintaxe

BOOL WTSEnumerateProcessesExA(
  [in]      HANDLE hServer,
  [in, out] DWORD  *pLevel,
  [in]      DWORD  SessionId,
  [out]     LPSTR  *ppProcessInfo,
  [out]     DWORD  *pCount
);

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 especifique WTS_CURRENT_SERVER_HANDLE para indicar o servidor no qual o aplicativo está em execução.

[in, out] pLevel

Um ponteiro para uma variável DWORD que, na entrada, especifica o tipo de informação a ser retornado. Para retornar uma matriz de estruturas de WTS_PROCESS_INFO , especifique zero. Para retornar uma matriz de estruturas de WTS_PROCESS_INFO_EX , especifique uma.

Se você não especificar um valor válido para esse parâmetro, na saída, WTSEnumerateProcessesEx definirá esse parâmetro como um e retornará um erro. Caso contrário, na saída, WTSEnumerateProcessesEx não alterará o valor desse parâmetro.

[in] SessionId

A sessão para a qual enumerar processos. Para enumerar processos para todas as sessões no servidor, especifique WTS_ANY_SESSION.

[out] ppProcessInfo

Um ponteiro para uma variável que recebe um ponteiro para uma matriz de estruturas de WTS_PROCESS_INFO ou WTS_PROCESS_INFO_EX . O tipo de estrutura é determinado pelo valor passado para o parâmetro pLevel . Cada estrutura na matriz contém informações sobre um processo ativo. Quando terminar de usar a matriz, libere-a chamando a função WTSFreeMemoryEx . Você também deve definir o ponteiro como NULL.

[out] pCount

Um ponteiro para uma variável que recebe o número de
estruturas retornadas no buffer referenciado pelo parâmetro ppProcessInfo .

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 a função GetLastError.

Comentários

O chamador deve ser um membro do grupo Administradores para enumerar processos em execução em outra sessão de usuário.

Observação

O cabeçalho wtsapi32.h define WTSEnumerateProcessesEx 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 7
Servidor mínimo com suporte Windows Server 2008 R2
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

WTSOpenServer

WTS_PROCESS_INFO

WTS_PROCESS_INFO_EX