AuthzInstallSecurityEventSource 函数 (authz.h)

  • 项目

AuthzInstallSecurityEventSource 函数将指定的源安装为安全事件源。

语法

AUTHZAPI BOOL AuthzInstallSecurityEventSource(
  [in] DWORD                             dwFlags,
  [in] PAUTHZ_SOURCE_SCHEMA_REGISTRATION pRegistration
);

参数

[in] dwFlags

此参数保留供将来使用，必须设置为零。

[in] pRegistration

指向 AUTHZ_SOURCE_SCHEMA_REGISTRATION 结构的指针，该结构包含有关要添加的安全事件源的信息。

AUTHZ_SOURCE_SCHEMA_REGISTRATION 结构的成员用于在安全日志密钥中安装安全事件源：

  • szEventSourceName 成员作为注册表项添加到下
    HKEY_LOCAL_MACHINE
   SYSTEM
      CurrentControlSet
         Services
            EventLog
               Security
  • szEventMessageFile 成员作为数据添加到事件源键下名为 EventMessageFile 的REG_SZ值中。
  • szEventAccessStringsFile 成员作为数据添加到事件源键下名为 ParameterMessageFile 的REG_SZ值中。
  • 如果注册表路径不存在，则会创建它。
  • 如果 szEventSourceXmlSchemaFile 成员不为 NULL，则将其作为数据添加到事件源键下名为 XmlSchemaFile 的REG_SZ值中。 不使用此值。
  • szExecutableImagePath 成员可以设置为 NULL。

返回值

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

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

要求

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

另请参阅

AUTHZ_SOURCE_SCHEMA_REGISTRATION

AuthzUninstallSecurityEventSource