EventLog plug-in: Difference between revisions

From NSIS Wiki
Jump to navigationJump to search
m (use <attach> for download)
 
(4 intermediate revisions by the same user not shown)
Line 37: Line 37:
;<category>
;<category>
:Event category. Can be any value and is specific to the event log currently written.
:Event category. Can be any value and is specific to the event log currently written.
:*"0" - None
:*"1" - Devices
:*"2" - Disk
:*"3" - Printers
:*"4" - Services
:*"5" - Shell
:*"6" - System
:*"7" - Network
;<message>
;<message>
:ID of the message to write. This id is specific to the event log currently written.
:ID of the message to write. This id is specific to the event log currently written.
;<text>
;<text>
:Message text to write to event log (up to 1024 bytes)  
:Message text to write to event log (up to 1024 bytes)


== Usage Example ==
== Usage Example ==
Line 52: Line 60:
== Credits ==
== Credits ==
Written by Stefano Giusto [sgiusto@mmpoint.it]
Written by Stefano Giusto [sgiusto@mmpoint.it]
Modified : add category's description by Ricardo Cardoso


[[Category:Plugins]]
[[Category:Plugins]]

Latest revision as of 10:27, 15 December 2009

Author: sgiusto@mmpoint.it (talk, contrib)


Download

EventLog.zip (34 KB)

Description

Version: 5th March 2007.
Supported on: Windows NT, Windows 2000, Windows XP.


The EventLog plugin for NSIS provides a function to write Events to the windows Event Log.


FUNCTIONS


EventLog::WriteEventLog <server> <log> <type> <category> <message> <text>

Writes an event to the EventLog Returns 1 on failure, 0 on success

<server>
Network name of PC to write events to
Leave blank to write to local PC
<log>
Event log to write
Standard windows Event Logs are "System" and "Application"
but other can be defined by user. If specific event log
is not found "Application" will be used
<type>
Type of message to write
  • "0" - Information
  • "1" - Error
  • "2" - Warning
<category>
Event category. Can be any value and is specific to the event log currently written.
  • "0" - None
  • "1" - Devices
  • "2" - Disk
  • "3" - Printers
  • "4" - Services
  • "5" - Shell
  • "6" - System
  • "7" - Network
<message>
ID of the message to write. This id is specific to the event log currently written.
<text>
Message text to write to event log (up to 1024 bytes)

Usage Example

#Write an informational message in a Custom Event Log
EventLog::WriteEventLog '' 'EventLogTest' '0' '0' '1' 'Info'
pop $0
#Handle result

Credits

Written by Stefano Giusto [sgiusto@mmpoint.it]

Modified : add category's description by Ricardo Cardoso