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 管理工具包 |