WTSConnectSessionA 函数（wtsapi32.h）

将远程桌面服务会话连接到本地计算机上的现有会话。

语法

BOOL WTSConnectSessionA(
  [in] ULONG LogonId,
  [in] ULONG TargetLogonId,
  [in] PSTR  pPassword,
  [in] BOOL  bWait
);

[in] LogonId

要连接到的会话的登录 ID。该会话的用户必须有权连接到现有会话。此会话的输出将路由到 TargetLogonId 参数标识的会话。

这可以 LOGONID_CURRENT 以使用当前会话。

[in] TargetLogonId

要接收由 LogonId 参数表示的会话的输出的会话的登录 ID。 LogonId 参数标识的会话的输出将路由到此会话。

这可以 LOGONID_CURRENT 以使用当前会话。

[in] pPassword

指向在 LogonId 参数中指定的用户帐户的密码的指针。如果调用方使用与登录 ID 相同的域名和用户名登录，则 pPassword 的值可以是空字符串。 pPassword 的值不能 NULL。

[in] bWait

指示操作是否同步。指定 TRUE 等待操作完成，或 FALSE 立即返回。

如果函数成功，则返回值为非零值。

如果函数失败，则返回值为零。若要获取扩展的错误信息，请调用 GetLastError。

LogonId 或 TargetLogonId 参数都可以 LOGONID_CURRENT，但不能同时 LOGONID_CURRENT。

注意

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