LogEvent

ITP/Server will send a message to the NT Event Logging Service.

Refer to the documentation of Microsoft Windows NT for an explanation of Source Identifiers, Event Types and Event IDs. The default behavior of ITP/Server is to write an error event to the event log with the text "Error: %1" where the %1 is substituted by the text of the parameter Record.

The following Event IDs are available through the ITPSERVERMSG.DLL:

Event ID

(Hexadecimal)

Text

3221225672

0xC00000C8

Error: %1.

1073742025

0x400000C9

Warning: %1.

1073742026

0x400000CA

Progress: %1.

1073742027

0x400000CB

Info: %1.

The ITPSERVERMSG.DLL must be installed on the host to have it show the correct text in the Event Viewer.

Syntax
LogEvent
Record(<text>)
Host(<text>)
EventType(<number>)
EventID(<number>)
Source(<text>);
Parameters

Record: Required.
The record (message text) that will be sent to the Event Log.

Host: Optional.
The remote host where the event will be logged. In order to see the correct text in the Event Viewer ITPSERVERMSG.DLL has to be installed on Host. If this parameter is not specified ITP/Server will log the record on the local machine; ITPSERVERMSG.DLL will automatically be installed on the host that ITP/Server is installed on.

EventType: Optional.
The type of the event that ITP/Server will log. If this parameter is not specified ITP/Server will log the record as type 1 (error).

EventID: Optional.
The ID of the event that ITP/Server will log. If this parameter is not specified ITP/Server will log the record with an ID of 3221225672 (0xC00000C8, see the table above).

Source: Optional.
The source identifier of the event that ITP/Server will log. If this parameter is not specified ITP/Server will use the source identifier "ITPEvent". If another Source is specified, the Event ID's as listed above become invalid.