Share via

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 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

要求 值
最低受支持的客户端 Windows 7
最低受支持的服务器 Windows Server 2008 R2
目标平台 Windows
标头 wtsapi32.h
Library Wtsapi32.lib
DLL Wtsapi32.dll

另请参阅

WTSCloseServer

WTSOpenServer