Función AuditSetSecurity (ntsecapi.h)

  • Artículo

La función AuditSetSecurity establece un descriptor de seguridad que delega el acceso a la directiva de auditoría.

Sintaxis

BOOLEAN AuditSetSecurity(
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

Parámetros

[in] SecurityInformation

Valor SECURITY_INFORMATION que especifica qué partes del descriptor de seguridad establece esta función. Solo se admiten SACL_SECURITY_INFORMATION y DACL_SECURITY_INFORMATION . Se omiten los demás valores. Si no se especifica ni SACL_SECURITY_INFORMATION ni DACL_SECURITY_INFORMATION , esta función produce un error y devuelve ERROR_INVALID_PARAMETER.

[in] pSecurityDescriptor

Puntero a una estructura de SECURITY_DESCRIPTOR bien formada que controla el acceso al objeto de seguridad Audit. Si este parámetro es NULL, se produce un error en la función y devuelve ERROR_INVALID_PARAMETER.

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.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ntsecapi.h
Library Advapi32.lib
Archivo DLL Advapi32.dll

Consulte también

AuditQuerySecurity