Función AuthzReportSecurityEvent (authz.h)

Artículo
02/23/2024

La función AuthzReportSecurityEvent genera una auditoría de seguridad para un origen de eventos de seguridad registrado.

La auditoría de la categoría de eventos de acceso a objetos debe estar habilitada para que la función AuthzReportSecurityEvent genere una auditoría de seguridad. Los tipos de auditoría disponibles se definen en la enumeración AUDIT_PARAM_TYPE .

Sintaxis

AUTHZAPI BOOL AuthzReportSecurityEvent(
  [in]           DWORD                                dwFlags,
  [in, out]      AUTHZ_SECURITY_EVENT_PROVIDER_HANDLE hEventProvider,
  [in]           DWORD                                dwAuditId,
  [in, optional] PSID                                 pUserSid,
  [in]           DWORD                                dwCount,
                 ...                                  
);

Parámetros

[in] dwFlags

Marcas que especifican el tipo de auditoría generada. En la siguiente tabla se muestran los valores posibles.

Valor	Significado
APF_AuditFailure 0x00000000	Se generan auditorías de errores.
APF_AuditSuccess 0x00000001	Se generan auditorías correctas.

[in, out] hEventProvider

Identificador del origen de eventos de seguridad registrado que se usará para la auditoría.

[in] dwAuditId

Identificador de la auditoría.

[in, optional] pUserSid

Puntero al identificador de seguridad (SID) que se mostrará como origen de la auditoría en el registro de eventos.

[in] dwCount

Número de pares tipo/valor auditParamFlag que aparecen en la sección de argumentos de variable que sigue este parámetro.

...

Lista de pares de tipo/valor AuditParamFlag que proporcionan información adicional sobre el evento.

Valor devuelto

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

Si se produce un error en la función, devuelve FALSE. Para obtener información de error extendida, llame a GetLastError.

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	authz.h
Library	Authz.lib
Archivo DLL	Authz.dll
Redistribuible	Paquete de herramientas de administración de Windows Server 2003 en Windows XP

Consulte también

AuthzRegisterSecurityEventSource

AuthzReportSecurityEventFromParams