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。
言论
调用方必须是 Administrators 组的成员,才能枚举在不同用户的上下文下运行的进程。
注意
wtsapi32.h 标头将 WTSEnumerateProcesses 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows Vista |
支持的最低服务器 | Windows Server 2008 |
目标平台 | 窗户 |
标头 | wtsapi32.h |
库 | Wtsapi32.lib |
DLL | Wtsapi32.dll |
API 集 | ext-ms-win-session-wtsapi32-l1-1-0(在 Windows 8 中引入) |