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

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

Синтаксис

BOOL WTSConnectSessionA(
  [in] ULONG LogonId,
  [in] ULONG TargetLogonId,
  [in] PSTR  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