Função WTSEnumerateProcessesExA (wtsapi32.h)
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) |