EventLog plug-in: Difference between revisions
From NSIS Wiki
Jump to navigationJump to search
mNo edit summary |
|||
| (6 intermediate revisions by 3 users not shown) | |||
| Line 2: | Line 2: | ||
== Download == | == Download == | ||
<attach>EventLog.zip</attach> | |||
== Description == | == Description == | ||
| Line 19: | Line 19: | ||
<highlight-nsis>EventLog::WriteEventLog <server> <log> <type> <category> <message> <text></highlight-nsis> | <highlight-nsis>EventLog::WriteEventLog <server> <log> <type> <category> <message> <text></highlight-nsis> | ||
Writes | Writes an event to the EventLog | ||
Returns 1 on failure, 0 on success | Returns 1 on failure, 0 on success | ||
| 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
