Get next event – Rockwell Automation 2711P Software Development Kit User Manual User Manual
Page 78

Publication 2711P-UM005A-EN-P - March 2007
78 PanelView Plus CE-Specific Extensions to the WinCE API
Get Next Event
This function reads the “next” Event from the Event Log in a specified
direction. This function permits an application to traverse the Event
Log in an ordered fashion. If the Event Log is traversed such that the
record after the end or the record before the first is sought then
EVENT_EOF will be returned.
DWORD GetNextEvent (UINT nIndex, UINT nDirection, EVENT
*pEvent);
Parameters:
nIndex
The index to an Event record in the Event Log.
nDirection
Determines the direction for locating the “next” record in the Event
Log. This parameter must be one of the following values:
pEvent
A pointer to an EVENT structure.
Event Types
Value
Description
PRIOR
Get the Event that occurred immediately prior to Event[nIndex]. The
returned Event will have an earlier time stamp than the Event at
nIndex.
AFTER
Get the Event that occurred immediately after Event[nIndex]. The
returned Event will have an later time stamp than the Event at
nIndex.