AuthzReportSecurityEventFromParams function (authz.h)

The AuthzReportSecurityEventFromParams function generates a security audit for a registered security event source by using the specified array of audit parameters.

Syntax

AUTHZAPI BOOL AuthzReportSecurityEventFromParams(
  [in]           DWORD                                dwFlags,
  [in]           AUTHZ_SECURITY_EVENT_PROVIDER_HANDLE hEventProvider,
  [in]           DWORD                                dwAuditId,
  [in, optional] PSID                                 pUserSid,
  [in]           PAUDIT_PARAMS                        pParams
);

Parameters

[in] dwFlags

Reserved for future use.

[in] hEventProvider

A handle to the registered security event source to use for the audit.

[in] dwAuditId

The identifier of the audit.

[in, optional] pUserSid

A pointer to the security identifier (SID) that will be listed as the source of the audit in the event log.

[in] pParams

An array of audit parameters.

Return value

If the function succeeds, the function returns TRUE.

If the function fails, it returns FALSE. For extended error information, call GetLastError.

Requirements

See also

AuthzRegisterSecurityEventSource

AuthzReportSecurityEvent