AuthzReportSecurityEvent function (authz.h)
The AuthzReportSecurityEvent function generates a security audit for a registered security event source.
Auditing for the object access event category must be enabled for the AuthzReportSecurityEvent function to generate a security audit. The available audit types are defined in the AUDIT_PARAM_TYPE enumeration.
Syntax
AUTHZAPI BOOL AuthzReportSecurityEvent(
[in] DWORD dwFlags,
[in, out] AUTHZ_SECURITY_EVENT_PROVIDER_HANDLE hEventProvider,
[in] DWORD dwAuditId,
[in, optional] PSID pUserSid,
[in] DWORD dwCount,
...
);
Parameters
[in] dwFlags
Flags that specify the type of audit generated. The following table shows the possible values.
| Value | Meaning |
|---|---|
|
Failure audits are generated. |
|
Success audits are generated. |
[in, out] 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] dwCount
The number of AuditParamFlag type/value pairs that appear in the variable arguments section that follows this parameter.
...
A list of AuditParamFlag type/value pairs that provide additional information about the event.
Return value
If the function succeeds, the function returns TRUE.
If the function fails, it returns FALSE. For extended error information, call GetLastError.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | None supported |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | authz.h |
| Library | Authz.lib |
| DLL | Authz.dll |
| Redistributable | Windows Server 2003 Administration Tools Pack on Windows XP |