Función AuditSetPerUserPolicy (ntsecapi.h)

  • Artículo

La función AuditSetPerUserPolicy establece la directiva de auditoría por usuario en una o varias subcategorías de auditoría para la entidad de seguridad especificada.

Sintaxis

BOOLEAN AuditSetPerUserPolicy(
  [in] const PSID                 pSid,
  [in] PCAUDIT_POLICY_INFORMATION pAuditPolicy,
  [in] ULONG                      dwPolicyCount
);

Parámetros

[in] pSid

Puntero a la estructura del SID asociada a la entidad de seguridad para la que se va a establecer la directiva de auditoría. Actualmente no se admite la directiva por usuario para los SID de grupo.

[in] pAuditPolicy

Puntero a una matriz de estructuras AUDIT_POLICY_INFORMATION . Cada estructura especifica la directiva de auditoría por usuario para una subcategoría de auditoría.

Se omite el miembro AuditCategoryGuid de estas estructuras.

[in] dwPolicyCount

Número de elementos de la matriz pAuditPolicy .

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.
ERROR_NO_SUCH_USER
1317
 La estructura de SID especificada por el parámetro pSID no está asociada a un usuario existente.

Comentarios

Para llamar correctamente a esta función, el autor de la llamada debe tener SeSecurityPrivilege o tener AUDIT_SET_USER_POLICY acceso en el objeto de seguridad Audit.

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

AuditQueryPerUserPolicy

AuditQuerySystemPolicy

AuditSetSystemPolicy