Struct OnceRegistration 

pub struct OnceRegistration { /* private fields */ }

Opaque non-clone claim for one registered Once callback.

Implementations

impl OnceRegistration

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

Return the claimed logical identity.

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

Return whether this exact claim currently owns an armed provider wake-up.

This is a volatile observation, not durable scheduling authority or a delivery guarantee. Call Self::ensure_scheduled unconditionally when a wake-up is required rather than using this value as a scheduling guard.

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

Ensure one invocation is armed or retained as the running work’s successor.

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

Reconcile to one exact desired schedule, replacing a later or earlier live deadline as necessary.

During running work, a winning exact schedule replaces the callback scheduling proposal before validation; explicit invariant failure stops.

None leaves a retained declaration inactive after any running work completes or is abandoned. A remove-on-stop declaration is removed and this claim expires when the transition finalizes.

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

Cancel the armed callback or the running work’s successor. Cancellation allocates no callback generation, even at the counter limit.

Consumer work already running is not interrupted. A retained declaration keeps callback authority. A remove-on-stop declaration and this claim expire when cancellation finalizes.

pub fn unregister(self) -> Result<(), TimerError>

Consume the claim and unregister its callback authority.

When called from running work, removal is deferred until that invocation completes normally or its confirmed delivery is abandoned.