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

Статья
08/28/2023

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

Синтаксис

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

Параметры

[in] hServer

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

[in, out] pLevel

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

Если вы не укажете допустимое значение для этого параметра, в выходных данных WTSEnumerateProcessesEx устанавливает для этого параметра значение 1 и возвращает ошибку. В противном случае при выходе 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
Целевая платформа	Windows
Header	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

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