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

See also

Basic Access Control Functions