Reschedule handle at newEpochTime and wait for completion.

Synopsis

Declared in <bdlmt_eventscheduler.h>

int
rescheduleEventAndWait(
    Event const* handle,
    bsls::TimeInterval const& newEpochTime);

Description

Reschedule the event referred to by the specified handle at the specified newEpochTime truncated to microseconds. Block until the event having handle (if it is valid) is either successfully rescheduled or dispatched before the call returns. Return 0 on successful reschedule, and a non‐zero value if handle is invalid or if the event has already been dispatched. The newEpochTime is an absolute time represented as an interval from some epoch, which is determined by the clock indicated at construction (see {Supported Clock Types} in the component documentation). The behavior is undefined if this method is invoked from the dispatcher thread.

Return Value

0 on successful reschedule, and a non‐zero value otherwise

Parameters

Name

Description

handle

event to reschedule

newEpochTime

new absolute time at which to dispatch the event

Created with MrDocs