Struct ServiceManager

pub struct ServiceManager { /* private fields */ }

Manages Windows services, providing functionalities to create, retrieve, and control services.

Implementations

impl ServiceManager

Examples

let service_manager = ServiceManager::new()?;
let service_name = "test";
let service_path = r"C:\Windows\system32\test.sys";
let service_handle = service_manager.create_or_get(ServiceConfig {
    service_name: service_name.to_string(),
    display_name: service_name.to_string(),
    binary_path: "invalid path test".to_string(),
    start_type: ServiceStartType::DemandStart,
    service_type: ServiceType::KernelDriver,
    ..Default::default()
})?;
assert_eq!(
    service_handle.get_start_type()?,
    ServiceStartType::DemandStart
);
service_handle.update_config(ServiceConfig {
    display_name: service_name.to_string(),
    binary_path: service_path.to_string(),
    service_type: ServiceType::KernelDriver,
    ..Default::default()
})?;
service_handle.start_blocking()?;
assert_eq!(service_handle.state()?, ServiceState::Running);
service_handle.stop_blocking()?;
assert_eq!(service_handle.state()?, ServiceState::Stopped);
std::thread::sleep(std::time::Duration::from_secs(2));
service_handle.delete()?;

pub fn new() -> Result<Self, ServiceManagerError>

Creates a new ServiceManager with access to the service control manager.

Errors

This function will return an error if it can’t open the service control manager.

pub fn create_service( &self, options: ServiceConfig, ) -> Result<ServiceHandle, CreateServiceError>

Creates a new service with the specified configuration.

Errors

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

pub fn get_service( &self, service_name: String, ) -> Result<ServiceHandle, OpenServiceError>

Retrieves an existing service by name.

Errors

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

pub fn create_or_get( &self, options: ServiceConfig, ) -> Result<ServiceHandle, CreateServiceError>

Creates a new service if it doesn’t exist, otherwise retrieves the existing service.

Errors

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

Trait Implementations

impl Drop for ServiceManager

fn drop(&mut self)

Executes the destructor for this type.