RegisterEventSource函数返回一个可以与ReportEvent函数一起使用的句柄来记录一个事件。
可以使用任何源名称;它将在事件日志记录中携带,以便事件查看器可以使用它进行过滤。
HANDLE RegisterEventSource(
LPCTSTR 【lpUNCServerName】, | //源的服务器名称 |
LPCTSTR 【lpSourceName】 | //注册句柄的源名称 |
); |
参数
【lpUNCServerName】
指向以空字符结尾的字符串,该字符串指定要执行此操作的服务器的通用命名约定(UNC)名称。如果此参数为NULL,则在本地计算机上执行该操作。
【lpSourceName】
指向一个以null结尾的字符串,指定返回句柄引用的源的名称。源名称必须是注册表中EventLog键下的日志文件条目的子项。例如,如果注册表具有以下格式,则源名称WinApp将有效:
HKEY_LOCAL_MACHINE
系统
CurrentControlSet
服务
EventLog
应用
WinApp
安全
系统
如果找不到源名称,则事件日志记录服务将使用应用日志文件,不带有事件标识符或类别的消息文件。
返回值
如果函数成功,则返回值是可以与ReportEvent函数一起使用的句柄。
如果函数失败,返回值为NULL。要获取扩展错误信息,请调用GetLastError.
也可以看看