TestWaitForUpdateCountGreater

Syntax

long TestWaitForUpdateCountGreater(COValue value, qword count, dword timeoutMs)

Function

Waits for the update counter of a communication object value to reach a certain value. Each CO value contains an update counter which is reset to 0 at measurement start and with explicit calls tovalueEntity::ResetValueState. You can read out the counter withvalueEntity::GetUpdateCount.

Parameters

COValue Value of a communication object.

count

Update count to be reached.

timeoutMS

Timeout in milliseconds.

Return Values

-2: Resume due to constraint violation

-1: General error, for example, functionality is not available

0: Resume due to timeout

1: resume due to event occurred (value was updated)

long ret;consumedEventRef * anEvent;anEvent = lookupConsumedEvent(path);// ...ret = testWaitForUpdateCountGreater(anEvent, anEvent.GetUpdateCount() + 3, 200);

[TestWaitForUpdateFlag](/en/syntax/communication-objects/misc/testwaitforupdateflag) | [TestWaitForUpdate](/en/syntax/communication-objects/misc/testwaitforupdate) | [TestWaitForChange](/en/syntax/communication-objects/misc/testwaitforchange)