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