通过

WTSEnumerateSessionsA 函数 （wtsapi32.h）

  • 项目

检索远程桌面会话主机（RD 会话主机）服务器上的会话列表。

语法

BOOL WTSEnumerateSessionsA(
  [in]  HANDLE             hServer,
  [in]  DWORD              Reserved,
  [in]  DWORD              Version,
  [out] PWTS_SESSION_INFOA *ppSessionInfo,
  [out] DWORD              *pCount
);

参数

[in] hServer

RD 会话主机服务器的句柄。

注释 可以使用 WTSOpenServer 或 WTSOpenServerEx 函数检索特定服务器的句柄，或 WTS_CURRENT_SERVER_HANDLE 使用托管应用程序的 RD 会话主机服务器。
 

[in] Reserved

此参数保留。 它必须为零。

[in] Version

枚举请求的版本。 此参数必须为 1。

[out] ppSessionInfo

指向表示检索的会话的 WTS_SESSION_INFO 结构的数组的指针。 若要释放返回的缓冲区，请调用 WTSFreeMemory 函数。

会话权限：

  • 若要枚举会话，必须启用查询信息权限。 有关详细信息，请参阅 远程桌面服务权限。
  • 若要更改会话的权限，请使用远程桌面服务配置管理工具。
  • 若要枚举在 RD 虚拟化主机服务器上托管的虚拟机上运行的会话，你必须是 RD 虚拟化主机服务器上的管理员组的成员。

[out] pCount

指向 ppSessionInfo 参数中返回的 WTS_SESSION_INFO 结构数的指针。

返回值

如果此函数失败，则返回零。 如果此函数成功，则返回非零值。

若要获取扩展的错误信息，请调用 GetLastError。

言论

注意

wtsapi32.h 标头将 WTSEnumerateSessions 定义为一个别名，该别名根据 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 中引入）

另请参阅

WTS_SESSION_INFO