Struct RestartSession 

pub struct RestartSession { /* private fields */ }

A primary-installer Restart Manager session.

Shutdown consumes this value and produces a RestartPending, so restart cannot be called out of sequence. This typestate is Send.

Implementations

impl RestartSession

pub fn new() -> Result<Self>

Starts a new primary-installer session.

pub fn session_key(&self) -> &SessionKey

Returns the key a secondary installer can pass to JoinedSession::join.

pub fn register_resources(&mut self, resources: &ResourceBatch) -> Result<()>

Registers a mixed collection in one native call.

pub fn register_files<I, P>(&mut self, files: I) -> Result<()>

where I: IntoIterator<Item = P>, P: AsRef<Path>,

Registers file paths. Directories are rejected by Restart Manager.

pub fn register_processes<I, P>(&mut self, processes: I) -> Result<()>

where I: IntoIterator<Item = P>, P: Borrow<ProcessIdentity>,

Registers exact process identities from any iterator.

pub fn register_services<I, S>(&mut self, services: I) -> Result<()>

where I: IntoIterator<Item = S>, S: AsRef<OsStr>,

Registers Windows services by short name.

pub fn affected_applications(&mut self) -> Result<AffectedApplications>

Takes a reusable snapshot of affected applications and reboot reasons.

pub fn cancellation_handle(&self) -> CancellationHandle

Creates a weak, thread-safe cancellation capability.

pub fn shutdown(self) -> RestartPending

Gracefully attempts shutdown and always enters the recovery-required state.

pub fn shutdown_with_options(self, options: ShutdownOptions) -> RestartPending

Attempts shutdown and retains its outcome regardless of native success.

pub fn shutdown_with_progress<F>( self, options: ShutdownOptions, callback: F, ) -> Result<RestartPending, OperationNotStarted<Self>>

where F: FnMut(Progress) + Send,

Attempts shutdown while delivering validated, strictly increasing progress.

If the process-global callback lease cannot be acquired, the returned error also returns this session and no native operation has started.

pub fn set_filter( &mut self, target: &FilterTarget, action: FilterAction, ) -> Result<()>

Adds or replaces a restart/shutdown filter.

pub fn remove_filter(&mut self, target: &FilterTarget) -> Result<()>

Removes a filter from the selected target.

pub fn filters(&mut self) -> Result<Vec<Filter>>

Lists filters configured by this primary installer.

pub fn end(self) -> Result<()>

Ends the session without attempting shutdown.