Función GetAuditedPermissionsFromAclA (aclapi.h)
La función GetAuditedPermissionsFromAcl recupera los derechos de acceso auditados de un administrador de confianza especificado. Los derechos auditados se basan en las entradas de control de acceso (ACE) de una lista de control de acceso (ACL) especificada. Los derechos de acceso auditados indican los tipos de intentos de acceso que hacen que el sistema genere un registro de auditoría en el registro de eventos del sistema. Los derechos auditados incluyen los que la ACL especifica para el administrador de confianza o para los grupos de los que el administrador es miembro. Al determinar los derechos auditados, la función no tiene en cuenta los privilegios de seguridad mantenidos por el administrador de confianza.
Sintaxis
DWORD GetAuditedPermissionsFromAclA(
[in] PACL pacl,
[in] PTRUSTEE_A pTrustee,
[out] PACCESS_MASK pSuccessfulAuditedRights,
[out] PACCESS_MASK pFailedAuditRights
);
Parámetros
[in] pacl
Puntero a una estructura de ACL desde la que se obtienen los derechos de acceso auditados del administrador.
[in] pTrustee
Puntero a una estructura DE CONFIANZA que identifica al administrador de confianza. Un administrador de confianza puede ser un usuario, un grupo o un programa (por ejemplo, un servicio de Windows). Puede usar un nombre o un identificador de seguridad (SID) para identificar un administrador de confianza. Para obtener información sobre las estructuras de SID, consulte SID.
[out] pSuccessfulAuditedRights
Puntero a una estructura de ACCESS_MASK que recibe la máscara de auditoría correcta para los derechos auditados para el administrador de confianza especificado por el parámetro pTrustee . El sistema genera un registro de auditoría cuando el administrador de confianza usa correctamente cualquiera de estos derechos de acceso.
[out] pFailedAuditRights
Puntero a una estructura de ACCESS_MASK que recibe la máscara de auditoría con errores para los derechos auditados para el administrador de confianza especificado por el parámetro pTrustee . El sistema genera un registro de auditoría cuando se produce un error en el administrador de confianza en un intento de usar cualquiera de estos derechos.
Valor devuelto
Si la función se realiza correctamente, la función devuelve ERROR_SUCCESS.
Si se produce un error en la función, devuelve un código de error distinto de cero definido en WinError.h.
Comentarios
La función GetAuditedPermissionsFromAcl comprueba todas las ACE de auditoría del sistema en la ACL para determinar los derechos auditados para el administrador de confianza. Para todas las ACE que especifican derechos auditados para un grupo, GetAuditedPermissionsFromAcl enumera los miembros del grupo para determinar si el administrador es miembro. La función devuelve un error si no puede enumerar los miembros de un grupo.
Nota
El encabezado aclapi.h define GetAuditedPermissionsFromAcl 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 XP [solo aplicaciones de escritorio] |
Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
Plataforma de destino | Windows |
Encabezado | aclapi.h |
Library | Advapi32.lib |
Archivo DLL | Advapi32.dll |
Consulte también
Información general del control de acceso
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de