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

Статья
11/20/2024

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

Синтаксис

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 TargetLogonId можно LOGONID_CURRENT, но не оба.

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista с пакетом обновления 1 (SP1)
минимальный поддерживаемый сервер	Windows Server 2008
целевая платформа	Виндоус
заголовка	wtsapi32.h
библиотеки	Wtsapi32.lib
DLL	Wtsapi32.dll

Поделиться через