Rockwell Automation 2711P Software Development Kit User Manual - Manual (Page 77)

Publication 2711P-UM005A-EN-P - March 2007
PanelView Plus CE-Specific Extensions to the WinCE API 77
Get First Event
This function reads the first or oldest Event from the Event log.
DWORD GetFirstEvent (EVENT*pEvent);
Parameters:
pEvent
A pointer to an EVENT structure.
Return Values:
Remarks:
This function is typically used to establish the starting position for an
iteration loop that traverses the Event Long in the oldest to newest
direction; i.e. first to last.
Use GetNextEvent() in a iteration loop with direction set to AFTER.
The time/date stamps will be ascending.
Portability:
This function is specific to the PanelView Plus CE.
Requirements:
GetFirstEvent - Return Codes
Value Description
EVENT_SUCCESS The first or oldest Event was read successfully and
returned to the structure at pEvent.
EVENT_ FILE_EMPTY No Event was returned The Event log is empty.
EVENT_FAIL No Event was returned. The operation failed.
Runs On Version Defined In Link To
PanelView Plus CE All EventLog.h EventLog.lib