AuthzOpenObjectAudit function

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


BOOL WINAPI 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        *SecurityDescriptorArray,
  _In_ DWORD                       SecurityDescriptorCount,
  _In_ PAUTHZ_ACCESS_REPLY         pReply
);

Parameters

Flags [in]

Reserved for future use.

hAuthzClientContext [in]

A handle to the client context of the object to open.

pRequest [in]

A pointer to an AUTHZ_ACCESS_REQUEST structure.

hAuditEvent [in]

A handle to the audit event to use.

pSecurityDescriptor [in]

A pointer to the SECURITY_DESCRIPTOR structure for the object.

SecurityDescriptorArray [in]

A pointer to an array of SECURITY_DESCRIPTOR structures.

SecurityDescriptorCount [in]

The number of elements in SecurityDescriptorArray.

pReply [in]

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

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Redistributable

Windows Server 2003 Administration Tools Pack on Windows XP

Header

Authz.h

Library

Authz.lib

DLL

Authz.dll

See also

Basic Access Control Functions

 

 

Show: