AuthzOpenObjectAudit function (authz.h)
The AuthzOpenObjectAudit function reads the system access control list (SACL) of the specified security descriptor and generates any appropriate audits specified by that SACL.
Syntax
AUTHZAPI BOOL AuthzOpenObjectAudit(
[in] DWORD Flags,
[in] AUTHZ_CLIENT_CONTEXT_HANDLE hAuthzClientContext,
[in] PAUTHZ_ACCESS_REQUEST pRequest,
[in] AUTHZ_AUDIT_EVENT_HANDLE hAuditEvent,
[in] PSECURITY_DESCRIPTOR pSecurityDescriptor,
[in] PSECURITY_DESCRIPTOR *OptionalSecurityDescriptorArray,
[in] DWORD OptionalSecurityDescriptorCount,
[in] PAUTHZ_ACCESS_REPLY pReply
);
Parameters
[in] Flags
Reserved for future use.
[in] hAuthzClientContext
A handle to the client context of the object to open.
[in] pRequest
A pointer to an AUTHZ_ACCESS_REQUEST structure.
[in] hAuditEvent
A handle to the audit event to use.
[in] pSecurityDescriptor
A pointer to the SECURITY_DESCRIPTOR structure for the object.
[in] OptionalSecurityDescriptorArray
A pointer to an array of SECURITY_DESCRIPTOR structures.
[in] OptionalSecurityDescriptorCount
The number of elements in SecurityDescriptorArray.
[in] pReply
A pointer to an AUTHZ_ACCESS_REPLY structure.
Return value
If the function succeeds, it returns a nonzero value.
If the function fails, it returns a zero value. To get extended error information, call GetLastError.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps only] |
| 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 |