Función WTSGetListenerSecurityA (wtsapi32.h)
Recupera el descriptor de seguridad de un agente de escucha de Servicios de Escritorio remoto.
Sintaxis
BOOL WTSGetListenerSecurityA(
[in] HANDLE hServer,
[in] PVOID pReserved,
[in] DWORD Reserved,
[in] LPSTR pListenerName,
[in] SECURITY_INFORMATION SecurityInformation,
[out, optional] PSECURITY_DESCRIPTOR pSecurityDescriptor,
[in] DWORD nLength,
[out] LPDWORD lpnLengthNeeded
);
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 SECURITY_INFORMATION que especifica la información de seguridad que se va a recuperar. Habilite siempre las marcas DACL_SECURITY_INFORMATION y SACL_SECURITY_INFORMATION .
Para obtener más información sobre los valores posibles, consulte SECURITY_INFORMATION.
[out, optional] pSecurityDescriptor
Puntero a una estructura SECURITY_DESCRIPTOR que recibe la información de seguridad asociada al agente de escucha al que hace referencia el parámetro pListenerName . La estructura SECURITY_DESCRIPTOR se devuelve en formato auto relativo. Para obtener más información sobre los valores posibles, consulte SECURITY_DESCRIPTOR.
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.
[in] nLength
Tamaño, en bytes, de la estructura SECURITY_DESCRIPTOR a la que hace referencia el parámetro pSecurityDescriptor .
[out] lpnLengthNeeded
Puntero a una variable que recibe el número de bytes necesarios para almacenar el descriptor de seguridad completo. Si este número es menor o igual que el valor del parámetro nLength , el descriptor de seguridad se copia en la estructura SECURITY_DESCRIPTOR a la que hace referencia el parámetro pSecurityDescriptor ; de lo contrario, no se realiza ninguna acción.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es un valor distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información ampliada de los errores, llame a la función GetLastError.
Comentarios
Si se desconoce el número de bytes necesarios para el búfer que recibe la estructura SECURITY_DESCRIPTOR , puede llamar a este método con nLength establecido en cero. A continuación, el método devolverá, en el parámetro lpnLengthNeeded , el número de bytes necesarios para el búfer. Asigne el búfer basado en este número y, a continuación, llame al método de nuevo, estableciendo pSecurityDescriptor en el búfer recién asignado y nLength al número devuelto por la primera llamada.
Nota
El encabezado wtsapi32.h define WTSGetListenerSecurity 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 Convenciones para prototipos de función.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 7 |
| Servidor mínimo compatible | Windows Server 2008 R2 |
| Plataforma de destino | Windows |
| Encabezado | wtsapi32.h |
| Library | Wtsapi32.lib |
| Archivo DLL | Wtsapi32.dll |