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

Статья
11/20/2024

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

Синтаксис

BOOL WTSEnumerateProcessesExA(
  [in]      HANDLE hServer,
  [in, out] DWORD  *pLevel,
  [in]      DWORD  SessionId,
  [out]     LPSTR  *ppProcessInfo,
  [out]     DWORD  *pCount
);

Параметры

[in] hServer

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

[in, out] pLevel

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

Если для этого параметра не указано допустимое значение, в выходных данных WTSEnumerateProcessesEx задает этот параметр одному и возвращает ошибку. В противном случае WTSEnumerateProcessesEx не изменяет значение этого параметра.

[in] SessionId

Сеанс, для которого необходимо перечислить процессы. Чтобы перечислить процессы для всех сеансов на сервере, укажите WTS_ANY_SESSION.

[out] ppProcessInfo

Указатель на переменную, которая получает указатель на массив WTS_PROCESS_INFO или WTS_PROCESS_INFO_EX структур. Тип структуры определяется значением, переданным параметру pLevel. Каждая структура в массиве содержит сведения об активном процессе. По завершении работы с массивом освободим его, вызвав функцию WTSFreeMemoryEx. Кроме того, необходимо задать указатель на NULL.

[out] pCount

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

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

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

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

Замечания

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 7
минимальный поддерживаемый сервер	Windows Server 2008 R2
целевая платформа	Виндоус
заголовка	wtsapi32.h
библиотеки	Wtsapi32.lib
DLL	Wtsapi32.dll
набор API	ext-ms-win-session-wtsapi32-l1-1-0 (представлено в Windows 8)

См. также

WTSOpenServer

WTS_PROCESS_INFO

WTS_PROCESS_INFO_EX

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