WTSOpenServerExA 函数（wtsapi32.h）

打开指定的远程桌面会话主机（RD 会话主机）服务器或远程桌面虚拟化主机（RD 虚拟化主机）服务器的句柄。

语法

HANDLE WTSOpenServerExA(
  [in] LPSTR pServerName
);

[in] pServerName

指向包含服务器的 NetBIOS 名称的以 null 结尾的字符串的指针。

如果函数成功，则返回值是指定服务器的句柄。

如果函数失败，它将返回无效句柄。可以通过在另一个函数调用中使用句柄来测试句柄的有效性。

如果 pServerName 参数指定的服务器是 RD 会话主机服务器，则此函数的行为与 WTSOpenServer 函数的行为相同。

若要处理在运行调用应用程序的 RD 虚拟化主机服务器上的虚拟机上运行的会话，请为 pServerName 参数指定 WTS_CURRENT_SERVER_NAME。

使用完此函数返回的句柄后，通过调用 WTSCloseServer 函数释放它。

注意

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