Функция WTSConnectSessionW (wtsapi32.h)

Подключает сеанс служб удаленных рабочих столов к существующему сеансу на локальном компьютере.

Синтаксис

BOOL WTSConnectSessionW(
  [in] ULONG LogonId,
  [in] ULONG TargetLogonId,
  [in] PWSTR pPassword,
  [in] BOOL  bWait
);

Параметры

[in] LogonId

Идентификатор входа в сеанс, к которому нужно подключиться. Пользователь этого сеанса должен иметь разрешения на подключение к существующему сеансу. Выходные данные этого сеанса будут перенаправлены в сеанс, определенный параметром TargetLogonId .

Это можно LOGONID_CURRENT для использования текущего сеанса.

[in] TargetLogonId

Идентификатор входа сеанса для получения выходных данных сеанса, представленный параметром LogonId . Выходные данные сеанса, определенные параметром LogonId , будут перенаправлены в этот сеанс.

Это можно LOGONID_CURRENT для использования текущего сеанса.

[in] pPassword

Указатель на пароль учетной записи пользователя, указанный в параметре LogonId . Значение pPassword может быть пустой строкой, если вызывающий объект входит в систему, используя то же доменное имя и имя пользователя, что и идентификатор входа. Значение pPassword не может иметь значение NULL.

[in] bWait

Указывает, является ли операция синхронной. Укажите значение TRUE , чтобы дождаться завершения операции, или значение FALSE для немедленного возврата.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет ненулевым.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Параметр LogonId или TargetLogonId можно LOGONID_CURRENT, но не оба.

Примечание

Заголовок wtsapi32.h определяет WTSConnectSession как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista с пакетом обновления 1 (SP1)
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	wtsapi32.h
Библиотека	Wtsapi32.lib
DLL	Wtsapi32.dll