Функция WTSSetListenerSecurityW (wtsapi32.h)
Настраивает дескриптор безопасности прослушивателя Служб удаленных рабочих столов.
Синтаксис
BOOL WTSSetListenerSecurityW(
[in] HANDLE hServer,
[in] PVOID pReserved,
[in] DWORD Reserved,
[in] LPWSTR pListenerName,
[in] SECURITY_INFORMATION SecurityInformation,
[in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);
Параметры
[in] hServer
Дескриптор сервера узла сеансов удаленных рабочих стола. Всегда присвойте этому параметру значение WTS_CURRENT_SERVER_HANDLE.
[in] pReserved
Этот параметр зарезервирован. Всегда присвойте этому параметру значение NULL.
[in] Reserved
Этот параметр зарезервирован. Всегда устанавливайте для этого параметра нулевое значение.
[in] pListenerName
Указатель на строку, завершающуюся нулевым значением, которая содержит имя прослушивателя.
[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 |
Целевая платформа | Windows |
Header | wtsapi32.h |
Библиотека | Wtsapi32.lib |
DLL | Wtsapi32.dll |
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по