Función GetAuditedPermissionsFromAclA (aclapi.h)

Artículo
02/23/2024

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