Función AuditQueryGlobalSaclW (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 que SeSecurityPrivilege que proteja la SACL global de que cualquier usuario sin privilegios de administrador actualice la SACL global.

Sintaxis

BOOLEAN AuditQueryGlobalSaclW(
  [in]  PCWSTR 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 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 o valor devuelto 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.

Comentarios

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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ntsecapi.h
Library Advapi32.lib
Archivo DLL Advapi32.dll