AuthzInitializeObjectAccessAuditEvent 函数 (authz.h)

  • 项目

AuthzInitializeObjectAccessAuditEvent 函数初始化对象的审核。

语法

AUTHZAPI BOOL AuthzInitializeObjectAccessAuditEvent(
  [in]  DWORD                         Flags,
  [in]  AUTHZ_AUDIT_EVENT_TYPE_HANDLE hAuditEventType,
  [in]  PWSTR                         szOperationType,
  [in]  PWSTR                         szObjectType,
  [in]  PWSTR                         szObjectName,
  [in]  PWSTR                         szAdditionalInfo,
  [out] PAUTHZ_AUDIT_EVENT_HANDLE     phAuditEvent,
  [in]  DWORD                         dwAdditionalParameterCount,
        ...                           
);

参数

[in] Flags

修改审核。 此参数的取值可为下列值之一：

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

[in] hAuditEventType

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

[in] szOperationType

指示要审核的操作的字符串。

[in] szObjectType

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

[in] szObjectName

字符串 指示被访问的对象的名称。

[in] szAdditionalInfo

字符串（由资源管理器定义）用于其他审核信息。

[out] phAuditEvent

接收 AUTHZ_AUDIT_EVENT_HANDLE 结构的指针。

[in] dwAdditionalParameterCount

必须设置为零。

...

其他参数。

返回值

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

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

要求

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

另请参阅

AuthzAccessCheck

基本访问控制函数