现在的位置: 首页 > 综合 > 正文

终端服务API

2014年01月04日 ⁄ 综合 ⁄ 共 1063字 ⁄ 字号 评论关闭
使用终端服务API
这一节描述了这样使用终端服务API在终端环境下去完成如下任务:
l         执行终端服务管理任务。例如:列举在一个域中的所有终端服务器,列举与管理一个终端服务器下的所有会话与进程。
l         在终端服务环境中增强一个客户/服务模式程序的功能。
l         在一个程序中使用终端虚拟通道使客户与服务组件进行通信。
l         设置或者取回一个特殊终端服务注册用户的配置信息。
假如你的程序在非终端环境下运行,但是你想在终端环境下利用终端服务API增强程序的功能,请看Run-time Linking to Wtsapi32.dll
一、终端服务管理
终端服务API函数使你能够列举与管理所有的终端服务器、客户会话以及进程。
为了得到一个域中所有终端服务器的名字,可以调NetServerEnum函数去列举所有SV_TYPE_TERMINALSERVER类型的终端服务器。通过传递一个终端服务器的名字调用WTSOpenServer函数可以打开一个特殊终端服务器的句柄,当完成操作后可以调用WTSCloseServer函数去关闭它。
你可以使用通过WTSOpenServer函数返回的终端服务器句柄在服务器中执行以下的操作:
函数 操作
WTSDisconnectSession 从一个特殊的会话中断开用户连接,但是这会话仍然存在,而且用户可以再次登陆并连接这个会话。
WTSEnumerateSessions 返回在一个特殊终端服务器中包括所有的会话的一个列表
WTSEnumerateProcesses 返回在一个特殊终端服务器中包括所有的进程的一个列表
WTSLogoffSession 登陆一个特殊的会话
WTSQuerySessionInformation 取回一个特殊终端服务器中一个特殊会话的信息
WTSSendMessage 在一个特殊会话下的客户端显示器上显示一个信息框。
WTSShutdownSystem 关闭或者启动一个终端服务器
WTSTerminateProcess 结束一个特殊终端服务器中特殊的进程
WTSVirtualChannelOpen 打开一个特殊虚拟终端服务端的句柄。为了得到更多的信息,请关注Using Terminal Services Virtual Channels.
WTSWaitSystemEvent 等待一个事件,例如一个客户会话的创建,一个用户登陆到一个终端服务器上。

    上面的一些函数分配了缓冲区来返回信息给调用者,在使用完这些缓冲区后请使用WTSFreeMemory函数去释放这些内存资源。 

抱歉!评论已关闭.