Функция 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)

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

WTS_PROCESS_INFO