Struct TimerContext 

pub struct TimerContext { /* private fields */ }

Delegated control capability scoped to one exact consumer-work attempt.

Identity remains inspectable after work returns, but mutation methods then return TimerError::RegistrationExpired. Retain the policy-specific registration capability for longer-lived ownership.

Implementations

impl TimerContext

pub const fn identity(&self) -> &TimerIdentity

Return the logical timer identity executing this work.

pub fn ensure_once(&self, schedule: TimerSchedule) -> Result<(), TimerError>

Schedule a Once declaration while this exact work attempt is active.

A context retained after its callback completes is expired and returns TimerError::RegistrationExpired.

pub fn reconcile_schedule( &self, schedule: Option<TimerSchedule>, ) -> Result<(), TimerError>

Reconcile the executing ordinary declaration to one exact schedule.

None leaves retained callback authority inactive, or removes a remove-on-stop declaration when cancellation wins arbitration. Watchdog declarations reject this operation. A stored context cannot mutate the registration after its exact work attempt ends.

pub fn ensure_recurring(&self) -> Result<(), TimerError>

Ensure recurrence while this exact work attempt is active.

pub fn cancel(&self) -> Result<(), TimerError>

Request cancellation while this exact work attempt is active.

A retained declaration becomes inactive. A remove-on-stop declaration is removed when cancellation wins arbitration.