WTSEnumerateProcessesA 函数 (wtsapi32.h)

检索有关指定远程桌面会话主机 (RD 会话主机) 服务器上的活动进程的信息。

语法

BOOL WTSEnumerateProcessesA(
  [in]  HANDLE             hServer,
  [in]  DWORD              Reserved,
  [in]  DWORD              Version,
  [out] PWTS_PROCESS_INFOA *ppProcessInfo,
  [out] DWORD              *pCount
);

参数

[in] hServer

RD 会话主机服务器的句柄。 指定 由 WTSOpenServer 函数打开的句柄，或指定 WTS_CURRENT_SERVER_HANDLE 以指示运行应用程序的 RD 会话主机服务器。

[in] Reserved

保留;必须为零。

[in] Version

指定枚举请求的版本。 必须为 1。

[out] ppProcessInfo

指向变量的指针，该变量接收指向 WTS_PROCESS_INFO 结构的数组的指针。 数组中的每个结构都包含有关指定 RD 会话主机服务器上的活动进程的信息。 若要释放返回的缓冲区，请调用 WTSFreeMemory 函数。

[out] pCount

指向一个变量的指针，该变量接收 ppProcessInfo 缓冲区中返回的WTS_PROCESS_INFO结构的数目。

返回值

如果函数成功，则返回值为非零值。

如果函数失败，则返回值为零。 要获得更多的错误信息，请调用 GetLastError。

注解

调用方必须是管理员组的成员，才能枚举在不同用户的上下文下运行的进程。

注意

wtsapi32.h 标头将 WTSEnumerateProcesses 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
目标平台	Windows
标头	wtsapi32.h
Library	Wtsapi32.lib
DLL	Wtsapi32.dll
API 集	在 Windows 8) 中引入的 ext-ms-win-session-wtsapi32-l1-1-0 (

另请参阅

WTS_PROCESS_INFO