Export (0) Print
Expand All
Expand Minimize

AuthzInitializeObjectAccessAuditEvent2 function

The AuthzInitializeObjectAccessAuditEvent2 function allocates and initializes an AUTHZ_AUDIT_EVENT_HANDLE handle for use with the AuthzAccessCheck function.

Syntax


BOOL WINAPI AuthzInitializeObjectAccessAuditEvent2(
  _In_   DWORD Flags,
  _In_   AUTHZ_AUDIT_EVENT_TYPE_HANDLE hAuditEventType,
  _In_   PWSTR szOperationType,
  _In_   PWSTR szObjectType,
  _In_   PWSTR szObjectName,
  _In_   PWSTR szAdditionalInfo,
  _In_   PWSTR szAdditionalInfo2,
  _Out_  PAUTHZ_AUDIT_EVENT_HANDLE phAuditEvent,
  _In_   DWORD dwAdditionalParameterCount
);

Parameters

Flags [in]

Flags that modify the behavior of the audit. The following table shows the possible values.

ValueMeaning
AUTHZ_NO_ALLOC_STRINGS

Uses pointers to the passed strings instead of allocating memory and copying the strings. The calling application must ensure that the passed memory remains valid during access checks.

AUTHZ_NO_FAILURE_AUDIT

Disables generation of failure audits.

AUTHZ_NO_SUCCESS_AUDIT

Disables generation of success audits.

 

hAuditEventType [in]

Reserved. This parameter should be set to NULL.

szOperationType [in]

A pointer to a string that indicates the operation that is to be audited.

szObjectType [in]

A pointer to a string that indicates the type of object accessed.

szObjectName [in]

A pointer to a string that indicates the name of the object accessed.

szAdditionalInfo [in]

Pointer to a string defined by the Resource Manager that contains additional audit information.

szAdditionalInfo2 [in]

Pointer to a string defined by the Resource Manager that contains additional audit information.

phAuditEvent [out]

A pointer to the returned AUTHZ_AUDIT_EVENT_HANDLE handle.

dwAdditionalParameterCount [in]

Must be set to zero.

Return value

If the function succeeds, it returns TRUE.

If the function fails, it returns FALSE. For extended error information, call GetLastError.

Requirements

Minimum supported client

None supported

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
AuthzAccessCheck

 

 

Community Additions

ADD
Show:
© 2014 Microsoft