TestWaitForUpdate

Valid for: CANoe DE • CANoe:lite DE • CANoe4SW DE • CANoe4SW:lite DE

Function Syntax

long TestWaitForUpdate(valueHandle * value, dword timeoutMs);

Waits for the next update of a valueHandle. This is equivalent to calling TestWaitForUpdateCountGreater (value, value.GetUpdateCount(), timeoutMs). Note that only updates which occur while the function waits are considered. If you want to wait for updates which may occur earlier, or if you want to wait for several updates, use TestWaitForUpdateFlag or TestWaitForUpdateCountGreater.

value: Value handle of a communication object or distributed object.
timeoutMS: Maximum time that should be waited [ms]. Transmission of 0: no timeout controlling.

long ret;
consumedEventRef * anEvent;
anEvent = lookupConsumedEvent(path);
// ...
ret = testWaitForUpdate(anEvent, 200);