Compartir a través de

Función AuditQueryGlobalSaclA (ntsecapi.h)

  • Artículo

La función AuditQueryGlobalSacl recupera una lista global de control de acceso del sistema (SACL) que delega el acceso a los mensajes de auditoría. La actualización de SACL global requiere el SeSecurityPrivilege, que protege la SACL global que cualquier usuario sin privilegios de administrador actualiza la SACL global.

Sintaxis

BOOLEAN AuditQueryGlobalSaclA(
  [in]  PCSTR ObjectTypeName,
  [out] PACL  *Acl
);

Parámetros

[in] ObjectTypeName

Puntero a una cadena terminada en NULL que especifica el tipo de objeto al que se accede. Este parámetro debe ser "File" o "Key", dependiendo de si el objeto es un archivo o registro. Esta cadena aparece en cualquier mensaje de auditoría que genere la función.

[out] Acl

Puntero a una estructura de de ACL que contiene la información de SACL. Esto debe liberarse más adelante llamando a la función LocalFree.

Valor devuelto

Si la función se ejecuta correctamente, devuelve TRUE.

Si se produce un error en la función, devuelve FALSE. Para obtener información de error extendida, llame a GetLastError. GetLastError puede devolver uno de los siguientes códigos de error definidos en WinError.h.

Código y valor devueltos Descripción
ERROR_ACCESS_DENIED
5
 El autor de la llamada no tiene los derechos de privilegio o acceso necesarios para llamar a esta función.
ERROR_INVALID_PARAMETER
87
 Uno o varios parámetros no son válidos.

Observaciones

Para llamar correctamente a esta función, el autor de la llamada debe tener SeSecurityPrivilege.

Nota

El encabezado ntsecapi.h define AuditQueryGlobalSacl 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 [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2008 R2 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de ntsecapi.h
biblioteca de Advapi32.lib
DLL de Advapi32.dll