AuthzRegisterSecurityEventSource 函数 (authz.h)

  • 项目

AuthzRegisterSecurityEventSource 函数将安全事件源注册到本地安全机构 (LSA) 。

语法

AUTHZAPI BOOL AuthzRegisterSecurityEventSource(
  [in]  DWORD                                 dwFlags,
  [in]  PCWSTR                                szEventSourceName,
  [out] PAUTHZ_SECURITY_EVENT_PROVIDER_HANDLE phEventProvider
);

参数

[in] dwFlags

此参数留待将来使用。 将此参数设置为零。

[in] szEventSourceName

指向要注册的安全事件源名称的指针。

[out] phEventProvider

指向已注册安全事件源的句柄的指针。

返回值

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

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

注解

此函数验证 szEventSourceName 参数，并设置相应的结构和 RPC 连接，以使用该源名称记录事件。 验证由对 LSA API 的基础调用处理。

LSA API 验证以下内容：

  • 调用方具有 SeAuditPrivilege 访问权限。
  • 事件源尚未使用。
  • 已注册事件源。
  • 调用应用程序匹配事件源注册中的可执行映像路径（如果存在）。

要求

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

另请参阅

AuthzUnregisterSecurityEventSource