Compartir a través de

Función AuditSetGlobalSaclA (ntsecapi.h)

  • Artículo

La función AuditSetGlobalSacl establece 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 AuditSetGlobalSaclA(
  [in]           PCSTR ObjectTypeName,
  [in, optional] PACL  Acl
);

Parámetros

[in] ObjectTypeName

Puntero a una cadena terminada en null que especifica el tipo de objeto que se crea o se accede a él. Para establecer la SACL global en los archivos, debe establecerse en "Archivo" y para establecer la SACL global en el registro, debe establecerse en "Clave". Esta cadena aparece en cualquier mensaje de auditoría que genere la función.

[in, optional] Acl

Puntero a una estructura de de ACL.

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 AuditSetGlobalSacl 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