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

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

  • Статья

Настраивает дескриптор безопасности прослушивателя служб удаленных рабочих столов.

Синтаксис

BOOL WTSSetListenerSecurityA(
  [in] HANDLE               hServer,
  [in] PVOID                pReserved,
  [in] DWORD                Reserved,
  [in] LPSTR                pListenerName,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

Параметры

[in] hServer

Дескриптор сервера узла сеанса удаленных рабочих точек. Всегда задайте для этого параметра значение WTS_CURRENT_SERVER_HANDLE.

[in] pReserved

Этот параметр зарезервирован. Всегда задайте для этого параметра значение NULL.

[in] Reserved

Этот параметр зарезервирован. Всегда установите для этого параметра значение нулю.

[in] pListenerName

Указатель на строку, завершающуюся значением NULL, которая содержит имя прослушивателя.

[in] SecurityInformation

Значение SECURITY_INFORMATION, указывающее заданные сведения о безопасности. Всегда включите флаги DACL_SECURITY_INFORMATION и SACL_SECURITY_INFORMATION.

Дополнительные сведения о возможных значениях см. в SECURITY_INFORMATION.

[in] pSecurityDescriptor

Указатель на структуру SECURITY_DESCRIPTOR, содержащую сведения о безопасности, связанные с прослушивателем. Дополнительные сведения о возможных значениях см. в SECURITY_DESCRIPTOR. Дополнительные сведения о STANDARD_RIGHTS_REQUIREDсм. в "Стандартные права доступа".

Список управления доступом (DACL) дескриптора безопасности может содержать одно или несколько следующих значений.

WTS_SECURITY_ALL_ACCESS

Объединяет следующие значения:

  • STANDARD_RIGHTS_REQUIRED
  • WTS_SECURITY_CONNECT
  • WTS_SECURITY_DISCONNECT
  • WTS_SECURITY_LOGON
  • WTS_SECURITY_MESSAGE
  • WTS_SECURITY_QUERY_INFORMATION
  • WTS_SECURITY_REMOTE_CONTROL
  • WTS_SECURITY_RESET
  • WTS_SECURITY_SET_INFORMATION
  • WTS_SECURITY_VIRTUAL_CHANNELS

WTS_SECURITY_CONNECT (256 (0x100))

Право подключения.

WTS_SECURITY_CURRENT_GUEST_ACCESS

Объединяет следующие значения:

  • WTS_SECURITY_LOGOFF
  • WTS_SECURITY_VIRTUAL_CHANNELS

WTS_SECURITY_CURRENT_USER_ACCESS

Объединяет следующие значения:

  • WTS_SECURITY_DISCONNECT
  • WTS_SECURITY_LOGOFF
  • WTS_SECURITY_RESET
  • WTS_SECURITY_SET_INFORMATION
  • WTS_SECURITY_VIRTUAL_CHANNELS

WTS_SECURITY_DISCONNECT (512 (0x200))

Право на отключение.

WTS_SECURITY_GUEST_ACCESS

Определяется как WTS_SECURITY_LOGON.

WTS_SECURITY_LOGOFF (64 (0x40))

Право выходить из системы.

WTS_SECURITY_LOGON (32 (0x20))

Право на вход.

WTS_SECURITY_MESSAGE (128 (0x80))

Право на отправку сообщения пользователю.

WTS_SECURITY_QUERY_INFORMATION (1 (0x1))

Право запрашивать информацию.

WTS_SECURITY_REMOTE_CONTROL (16 (0x10))

Право на использование удаленного управления.

WTS_SECURITY_RESET (4 (0x4))

Право на сброс сведений.

WTS_SECURITY_SET_INFORMATION (2 (0x2))

Право задать сведения.

WTS_SECURITY_USER_ACCESS

Объединяет следующие значения:

  • WTS_SECURITY_CONNECT
  • WTS_SECURITY_CURRENT_GUEST_ACCESS
  • WTS_SECURITY_QUERY_INFORMATION

WTS_SECURITY_VIRTUAL_CHANNELS (8 (0x8))

Право использовать виртуальные каналы.

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

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

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

Замечания

Заметка

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

Требования

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

См. также

SECURITY_DESCRIPTOR

SECURITY_INFORMATION