Share via

AuthzInitializeObjectAccessAuditEvent2 函数 (authz.h)

  • 项目

AuthzInitializeObjectAccessAuditEvent2 函数分配并初始化AUTHZ_AUDIT_EVENT_HANDLE句柄，以便与 AuthzAccessCheck 函数一起使用。

语法

AUTHZAPI BOOL 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,
        ...                           
);

参数

[in] Flags

修改审核行为的标志。 下表列出了可能的值。

“值” 含义
AUTHZ_NO_ALLOC_STRINGS
 使用指向传递字符串的指针，而不是分配内存和复制字符串。 调用应用程序必须确保传递的内存在访问检查期间保持有效。
AUTHZ_NO_FAILURE_AUDIT
 禁用失败审核的生成。
AUTHZ_NO_SUCCESS_AUDIT
 禁用成功审核的生成。

[in] hAuditEventType

保留。 此参数应设置为 NULL。

[in] szOperationType

指向字符串的指针，该字符串指示要审核的操作。

[in] szObjectType

指向指示所访问对象类型的字符串的指针。

[in] szObjectName

指向指示所访问对象名称的字符串的指针。

[in] szAdditionalInfo

指向由包含其他审核信息的资源管理器定义的字符串的指针。

[in] szAdditionalInfo2

指向由包含其他审核信息的资源管理器定义的字符串的指针。

[out] phAuditEvent

指向返回 的AUTHZ_AUDIT_EVENT_HANDLE 句柄的指针。

[in] dwAdditionalParameterCount

必须设置为零。

...

其他参数。

返回值

如果该函数成功，则返回 TRUE。

如果函数失败，则返回 FALSE。 有关扩展的错误信息，请调用 GetLastError。

要求

要求 值
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 authz.h
Library Authz.lib
DLL Authz.dll
可再发行组件 Windows XP 上的 Windows Server 2003 管理工具包

另请参阅

AuthzAccessCheck

基本访问控制函数