Функция WTSEnumerateProcessesW (wtsapi32.h)
Извлекает сведения о активных процессах на указанном сервере узла сеансов удаленных рабочих столов (узла сеансов удаленных рабочих столов).
Синтаксис
BOOL WTSEnumerateProcessesW(
[in] HANDLE hServer,
[in] DWORD Reserved,
[in] DWORD Version,
[out] PWTS_PROCESS_INFOW *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) |