Função WTSEnumerateProcessesA (wtsapi32.h)

Artigo
11/20/2024

Recupera informações sobre os processos ativos em um servidor de Host de Sessão da Área de Trabalho Remota (Host de Sessão de Área de Trabalho Remota) especificado.

Sintaxe

BOOL WTSEnumerateProcessesA(
  [in]  HANDLE             hServer,
  [in]  DWORD              Reserved,
  [in]  DWORD              Version,
  [out] PWTS_PROCESS_INFOA *ppProcessInfo,
  [out] DWORD              *pCount
);

Parâmetros

[in] hServer

Manipule 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 host da sessão rd no qual seu aplicativo está em execução.

[in] Reserved

Reservado; deve ser zero.

[in] Version

Especifica a versão da solicitação de enumeração. Deve ser 1.

[out] ppProcessInfo

Ponteiro para uma variável que recebe um ponteiro para uma matriz de estruturas WTS_PROCESS_INFO. Cada estrutura na matriz contém informações sobre um processo ativo no servidor host de sessão rd especificado. Para liberar o buffer retornado, chame a função WTSFreeMemory.

[out] pCount

Ponteiro para uma variável que recebe o número de estruturas de WTS_PROCESS_INFO retornadas no buffer 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 GetLastError.

Observações

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

Nota

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

WTS_PROCESS_INFO

Compartilhar via