Compartir a través de

Función WTSSetListenerSecurityA (wtsapi32.h)

  • Artículo

Configura el descriptor de seguridad de un agente de escucha de Servicios de Escritorio remoto.

Sintaxis

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

Parámetros

[in] hServer

Identificador de un servidor host de sesión de Escritorio remoto. Establezca siempre este parámetro en WTS_CURRENT_SERVER_HANDLE.

[in] pReserved

Este parámetro está reservado. Establezca siempre este parámetro en NULL.

[in] Reserved

Este parámetro está reservado. Establezca siempre este parámetro en cero.

[in] pListenerName

Puntero a una cadena terminada en null que contiene el nombre del agente de escucha.

[in] SecurityInformation

Valor de SECURITY_INFORMATION que especifica la información de seguridad que se va a establecer. Habilite siempre las marcas DACL_SECURITY_INFORMATION y SACL_SECURITY_INFORMATION.

Para obtener más información sobre los valores posibles, vea SECURITY_INFORMATION.

[in] pSecurityDescriptor

Puntero a una estructura SECURITY_DESCRIPTOR que contiene la información de seguridad asociada al agente de escucha. Para obtener más información sobre los valores posibles, vea SECURITY_DESCRIPTOR. Para obtener información sobre STANDARD_RIGHTS_REQUIRED, vea Derechos de acceso estándar.

La lista de control de acceso discrecional (DACL) del descriptor de seguridad puede contener uno o varios de los valores siguientes.

WTS_SECURITY_ALL_ACCESS

Combina estos valores:

  • 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))

Derecho a conectarse.

WTS_SECURITY_CURRENT_GUEST_ACCESS

Combina estos valores:

  • WTS_SECURITY_LOGOFF
  • WTS_SECURITY_VIRTUAL_CHANNELS

WTS_SECURITY_CURRENT_USER_ACCESS

Combina estos valores:

  • WTS_SECURITY_DISCONNECT
  • WTS_SECURITY_LOGOFF
  • WTS_SECURITY_RESET
  • WTS_SECURITY_SET_INFORMATION
  • WTS_SECURITY_VIRTUAL_CHANNELS

WTS_SECURITY_DISCONNECT (512 (0x200))

Derecho a desconectar.

WTS_SECURITY_GUEST_ACCESS

Se define como WTS_SECURITY_LOGON.

WTS_SECURITY_LOGOFF (64 (0x40))

Derecho a cerrar sesión.

WTS_SECURITY_LOGON (32 (0x20))

Derecho a iniciar sesión.

WTS_SECURITY_MESSAGE (128 (0x80))

Derecho a enviar un mensaje al usuario.

WTS_SECURITY_QUERY_INFORMATION (1 (0x1))

Derecho a consultar información.

WTS_SECURITY_REMOTE_CONTROL (16 (0x10))

Derecho a usar el control remoto.

WTS_SECURITY_RESET (4 (0x4))

Derecho a restablecer la información.

WTS_SECURITY_SET_INFORMATION (2 (0x2))

Derecho a establecer información.

WTS_SECURITY_USER_ACCESS

Combina estos valores:

  • WTS_SECURITY_CONNECT
  • WTS_SECURITY_CURRENT_GUEST_ACCESS
  • WTS_SECURITY_QUERY_INFORMATION

WTS_SECURITY_VIRTUAL_CHANNELS (8 (0x8))

Derecho a usar canales virtuales.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un valor distinto de cero.

Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a la función GetLastError.

Observaciones

Nota

El encabezado wtsapi32.h define WTSSetListenerSecurity como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 7
servidor mínimo admitido Windows Server 2008 R2
de la plataforma de destino de Windows
encabezado de wtsapi32.h
biblioteca de Wtsapi32.lib
DLL de Wtsapi32.dll

Consulte también

SECURITY_DESCRIPTOR

SECURITY_INFORMATION