Windows终端服务（Terminal Service）函数族

时间：2011-06-02 来源：漂泊的云

Windows的终端服务相关的函数都以WTS开头。使用这些函数需要包含头文件和链接库：

#include <WtsApi32.h>
#pragma comment(lib, "WtsApi32.lib")

典型的函数如下：

函数	功能
WTSOpenServer	打开到一个远程机器（的访问链接），通过返回值的HANDLE，可以对该机器发送消息（WTSSendMessage）、远程关机/重启（WTSShutdownSystem）、连接/断开远程登录会话（WTSStartRemoteControlSession/WTSStopRemoteControlSession)、远程结束进程（WTSTerminateProcess）、远程注销登录会话（WTSLogoffSession）等。
WTSCloseServer	关闭由WTSOpenServer打开的句柄。
WTSEnumerateProcesses	枚举指定Server（WTSOpenServer打开或者WTS_CURRENT_SERVER_HANDLE本机）上的所有进程。
WTSEnumerateServers	枚举Domain内的搜有Server。（需要NetBT支持）
WTSEnumerateSessions	枚举指定Server上的所有登录会话。
WTSQueryUserToken	获取指定登录会话SessionID的用户Token。典型的可以使用WTSGetActiveConsoleSessionId获取当前活动的登录会话iD（非系统服务）。

一些注意事项：

由WTSOpenServer打开的HANDLE必须由WTSCloseServer关闭哦，否则，你会发现远程机器无法正常关机了（特别是你调用WTSTerminateProcess时，等半天就是关不了机，还以为函数调用失败了）。

使用举例：

在系统服务中创建一个会话进程（仅系统服务可行）：

HANDLE                             hUserToken(NULL);
HANDLE                          hCurToken(NULL);
LUID                            luid;
TOKEN_PRIVILEGES        tkp;
TOKEN_PRIVILEGES        tkpNew; 
DWORD                           dwSize(0);

::OpenProcessToken(GetCurrentProcess(), TOKEN_ADJUST_PRIVILEGES | TOKEN_QUERY, &hCurToken);
tkp.PrivilegeCount      = 0;
::LookupPrivilegeValue(NULL, SE_INCREASE_QUOTA_NAME, &luid); 
tkp.Privileges[tkp.PrivilegeCount].Luid                 = luid;
tkp.Privileges[tkp.PrivilegeCount].Attributes   = SE_PRIVILEGE_ENABLED;
tkp.PrivilegeCount++;
::LookupPrivilegeValue(NULL, SE_ASSIGNPRIMARYTOKEN_NAME, &luid); 
tkp.Privileges[tkp.PrivilegeCount].Luid                 = luid;
tkp.Privileges[tkp.PrivilegeCount].Attributes   = SE_PRIVILEGE_ENABLED;
tkp.PrivilegeCount++;
::LookupPrivilegeValue(NULL, SE_TCB_NAME, &luid); 
tkp.Privileges[tkp.PrivilegeCount].Luid                 = luid;
tkp.Privileges[tkp.PrivilegeCount].Attributes   = SE_PRIVILEGE_ENABLED;
::AdjustTokenPrivileges(hCurToken, FALSE, &tkp, sizeof(tkp), &tkpNew, &dwSize);
::WTSQueryUserToken(WTSGetActiveConsoleSessionId(), &hUserToken);
::CreateProcessAsUser(hUserToken, NULL, L"c:\\Windows\\system32\\calc.exe",
        NULL, NULL, FALSE, 0, NULL, L"c:\\Windows\\system32\\", NULL, NULL);