Struct Service 

pub struct Service<'a> { /* private fields */ }

A service builder, providing control over what commands the service supports before the service begins to run.

Implementations

impl<'a> Service<'a>

pub fn new() -> Self

Creates a new Service object.

By default, the service does not accept any service commands other than start.

pub fn can_stop(&mut self) -> &mut Self

The service accepts stop and shutdown commands.

pub fn can_pause(&mut self) -> &mut Self

The service accepts pause and resume commands.

pub fn can_accept(&mut self, accept: u32) -> &mut Self

The service accepts other specified commands.

pub fn can_fallback<F: FnOnce(&Service<'_>) + Send + 'a>( &mut self, f: F, ) -> &mut Self

Runs the fallback closure if the service is not started by the Service Control Manager.

pub fn run<F: FnMut(&Service<'_>, Command) + Send + Sync + 'a>( &mut self, callback: F, ) -> Result<(), &'static str>

Runs the service with the given callback closure to receive commands sent by the service control manager.

This method will block for the life of the service. It will never return and immediately terminate the current process after indicating to the service control manager that the service has stopped.

pub fn set_state(&self, state: State)

Sets the current state of the service.

In most cases, the service state is updated automatically and does not need to be set directly.

pub fn handle(&self) -> *mut c_void

The raw handle representing the service.

pub fn state(&self) -> State

The current state the service.

pub fn command(&self, command: Command)

Sends the command to the service callback.

pub fn handler( &self, control: u32, event_type: u32, event_data: *const c_void, ) -> u32

Low-level dispatcher to send control commands directly to the service.

Trait Implementations

impl Default for Service<'_>

fn default() -> Self

Returns the “default value” for a type.

impl Send for Service<'_>

impl Sync for Service<'_>