Função WTSEnumerateProcessesExA (wtsapi32.h)

Artigo
11/20/2024

Recupera informações sobre os processos ativos no servidor do Host da Sessão da Á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 retornada. Para retornar uma matriz de estruturas de WTS_PROCESS_INFO, especifique zero. Para retornar uma matriz de estruturas 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 para NULL.

[out] pCount

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

Valor de retorno

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.

Observações

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

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 7
servidor com suporte mínimo	Windows Server 2008 R2
da Plataforma de Destino	Windows
cabeçalho	wtsapi32.h
biblioteca	Wtsapi32.lib
de DLL	Wtsapi32.dll
conjunto de API	ext-ms-win-session-wtsapi32-l1-1-0 (introduzido no Windows 8)

Consulte também

WTSOpenServer

WTS_PROCESS_INFO

WTS_PROCESS_INFO_EX

Compartilhar via