Struct ServiceStatus

pub struct ServiceStatus {
    pub service_type: ServiceType,
    pub current_state: ServiceState,
    pub controls_accepted: ServiceControlAccept,
    pub exit_code: ServiceExitCode,
    pub checkpoint: u32,
    pub wait_hint: Duration,
    pub process_id: Option<u32>,
}

Service status.

This struct wraps the lower level SERVICE_STATUS providing a few convenience types to fill in the service status information. However it doesn’t fully guard the developer from producing an invalid ServiceStatus, therefore please refer to the corresponding MSDN article and in particular how to fill in the exit_code, checkpoint, wait_hint fields:
https://msdn.microsoft.com/en-us/library/windows/desktop/ms685996(v=vs.85).aspx

Fields

service_type: ServiceType

Type of service.

current_state: ServiceState

Current state of the service.

controls_accepted: ServiceControlAccept

Control commands that service accepts.

exit_code: ServiceExitCode

The error code the service uses to report an error that occurs when it is starting or stopping.

checkpoint: u32

Service initialization progress value that should be increased during a lengthy start, stop, pause or continue operations. For example the service should increment the value as it completes each step of initialization. This value must be zero if the service does not have any pending start, stop, pause or continue operations.

wait_hint: Duration

Estimated time for pending operation. This basically works as a timeout until the system assumes that the service hung. This could be either circumvented by updating the ServiceStatus::current_state or incrementing a ServiceStatus::checkpoint value.

Panics

Converting this to the FFI form will panic if the duration is too large to fit as milliseconds in a u32.

process_id: Option<u32>

Process ID of the service This is only retrieved when querying the service status.

Trait Implementations

impl Clone for ServiceStatus

fn clone(&self) -> ServiceStatus

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ServiceStatus

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

Formats the value using the given formatter.

impl Hash for ServiceStatus

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ServiceStatus

fn eq(&self, other: &ServiceStatus) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for ServiceStatus

impl StructuralPartialEq for ServiceStatus