beautypg.com

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

Page 78

background image

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.