EventLog plug-in: Difference between revisions
From NSIS Wiki
Jump to navigationJump to search
No edit summary |
|||
(11 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
{{PageAuthor|sgiusto@mmpoint.it}} | {{PageAuthor|sgiusto@mmpoint.it}} | ||
== | == Download == | ||
<attach>EventLog.zip</attach> | <attach>EventLog.zip</attach> | ||
== Description == | == Description == | ||
'''Version:''' 5th March 2007.<br> | |||
'''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 | |||
--------- | |||
<highlight-nsis>EventLog::WriteEventLog <server> <log> <type> <category> <message> <text></highlight-nsis> | |||
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 == | |||
<highlight-nsis> | |||
#Write an informational message in a Custom Event Log | |||
EventLog::WriteEventLog '' 'EventLogTest' '0' '0' '1' 'Info' | |||
pop $0 | |||
#Handle result | |||
</highlight-nsis> | |||
== Credits == | |||
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