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

Статья
08/28/2023

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

Синтаксис

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)

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

WTS_PROCESS_INFO