Функция WTSEnumerateProcessesA (wtsapi32.h)

  • Статья

Извлекает сведения об активных процессах на указанном сервере узла сеансов удаленных рабочих столов (узел сеансов удаленных рабочих столов).

Синтаксис

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

Параметры

[in] hServer

Обработка на сервере узла сеансов удаленных рабочих стола. Укажите дескриптор, открытый функцией WTSOpenServer , или укажите WTS_CURRENT_SERVER_HANDLE , чтобы указать сервер узла сеансов удаленных рабочих столов, на котором выполняется приложение.

[in] Reserved

Защищены; значение должно быть равно нулю.

[in] Version

Указывает версию запроса перечисления. Должен иметь значение 1.

[out] ppProcessInfo

Указатель на переменную, получающую указатель на массив WTS_PROCESS_INFO структур. Каждая структура в массиве содержит сведения об активном процессе на указанном сервере узла сеансов удаленных рабочих стола. Чтобы освободить возвращенный буфер, вызовите функцию WTSFreeMemory .

[out] pCount

Указатель на переменную, которая получает количество WTS_PROCESS_INFO структур, возвращаемых в буфере ppProcessInfo .

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет ненулевым.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Вызывающий объект должен быть членом группы Администраторы для перечисления процессов, выполняемых в контексте другого пользователя.

Примечание

Заголовок wtsapi32.h определяет WTSEnumerateProcesses в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Целевая платформа Windows
Header wtsapi32.h
Библиотека Wtsapi32.lib
DLL Wtsapi32.dll
Набор API ext-ms-win-session-wtsapi32-l1-1-0 (представлено в Windows 8)

См. также раздел

WTS_PROCESS_INFO