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 |
|
|
Library |
|
|
DLL |
|
See also