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

Статья
11/20/2024

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

Синтаксис

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
целевая платформа	Виндоус
заголовка	wtsapi32.h
библиотеки	Wtsapi32.lib
DLL	Wtsapi32.dll
набор API	ext-ms-win-session-wtsapi32-l1-1-0 (представлено в Windows 8)

См. также

WTS_PROCESS_INFO

Поделиться через