Isiupdateuserinterface() – Echelon ISI User Manual
Page 152
ISI Programmer’s Guide
150
IsiUpdateUserInterface()
void IsiUpdateUserInterface(IsiEvent
Event
, unsigned
Parameter
);
Provides status feedback from the ISI engine. These events are useful for
synchronizing the device’s user interface with the ISI engine. To receive
notification of ISI status events, override the IsiUpdateUserInterface() callback
function. The default implementation of IsiUpdateUserInterface() does nothing.
The ISI engine calls this function with the
Event
parameter set to one of the
values defined for the IsiEvent enumeration in Appendix A. Some of these
events carry a meaningful value in the
Parameter
argument, as detailed in the
IsiEvent definition.
You can use the
Event
parameter passed to the IsiUpdateUserInterface()
callback function to track the state of the ISI engine. This is a simple way to
determine which ISI function calls make sense at any time, and which ones don’t.
The following table lists this state information, based on the last
Event
value
provided with this callback, over possible ISI actions:
isiPending
isiPending
Host/
isiApproved
isiApproved
Host
isiNormal
IsiCancelEnrollment
9
9
IsiCreateEnrollment
9
9
IsiExtendEnrollment
9
9
IsiDeleteEnrollment
9
IsiLeaveEnrollment
9
IsiOpenEnrollment
9
IsiAcquireDomain
9
IsiStartDeviceAcquisition
9
IsiReturnToFactoryDefaults
9
9
9
9