Struct ServiceHandle

pub struct ServiceHandle { /* private fields */ }

Represents a handle to a Windows service.

Implementations

impl ServiceHandle

pub fn new(handle: SC_HANDLE) -> Self

Creates a new ServiceHandle.

pub fn state(&self) -> Result<ServiceState, QueryServiceError>

Returns the current state of this ServiceHandle.

Errors

This function will return an error if it can’t retrieve the service status.

pub fn update_config( &self, options: ServiceConfig, ) -> Result<(), UpdateServiceError>

Updates the configuration of the service.

Errors

This function will return an error if it can’t update the service configuration.

pub fn get_start_type(&self) -> Result<ServiceStartType, QueryServiceError>

Returns the get start type of this ServiceHandle.

Errors

This function will return an error if it can’t get the start type.

pub fn set_start_type( &self, start_type: ServiceStartType, ) -> Result<(), UpdateServiceError>

Sets the start type of the service.

Errors

This function will return an error if it can’t set the start type.

pub fn delete(&self) -> Result<(), DeleteServiceError>

pub fn start_blocking(&self) -> Result<(), ControlServiceError>

Starts the service and blocks until it is running.

Errors

This function will return an error if it can’t start the service.

pub fn stop_blocking(&self) -> Result<(), ControlServiceError>

Stops the service and blocks until it is stopped.

Errors

This function will return an error if it can’t stop the service.

pub fn pause_blocking(&self) -> Result<(), ControlServiceError>

Pauses the service and blocks until it is paused.

Errors

This function will return an error if it can’t pause the service.

pub fn start(&self) -> Result<(), ControlServiceError>

Starts the service.

Errors

This function will return an error if it can’t start the service.

pub fn stop(&self) -> Result<(), ControlServiceError>

Stops the service.

Errors

This function will return an error if it can’t stop the service.

pub fn pause(&self) -> Result<(), ControlServiceError>

Pauses the service.

Errors

This function will return an error if it can’t pause the service.

Trait Implementations

impl Debug for ServiceHandle

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ServiceHandle

fn default() -> ServiceHandle

Returns the “default value” for a type.

impl Display for ServiceHandle

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Drop for ServiceHandle

fn drop(&mut self)

Executes the destructor for this type.