Name
Read
Synopsis
$log->Read(flags,offset, \%eventinfo)
Reads an entry from the event log and returns the
information in the eventinfo hash.
offset specifies the record number you
want to start at in the log. flags sets
options for how you want to read the log, which can be any
combination of the following:
EVENTLOG_FORWARDS_READEventlog is read in forward chronological order.
EVENTLOG_BACKWARDS_READEventlog is read in reverse chronological order.
EVENTLOG_SEEK_READThe read begins at the record specified by the
$RecordOffsetparameter. Must also specifyEVENT_LOG_FORWARDS_READorEVENTLOG_BACKWARDS_READ.EVENTLOG_SEQUENTIAL_READThe read continues sequentially from the last
readcall.
The final argument is the output object for the event read.
eventinfo is a reference to a hash that
contains keys for each part of the event description. This same
structure is used when you report new events to the event log
using the Report method. The
eventinfo hash looks like this:
%event = (
EventID => val,
EventType => val,
Category => val,
ClosingRecordNumber => val,
Source => val,
Computer => val,
Strings => val,
Data => val,
);