winsafe 0.0.27

Windows API and GUI in safe, idiomatic Rust.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

#![allow(non_camel_case_types, non_snake_case)]

use crate::advapi::ffi;
use crate::co;
use crate::decl::*;
use crate::guard::*;
use crate::kernel::privs::*;

handle! { HSC;
	/// Handle to a
	/// [Service Control Manager](https://learn.microsoft.com/en-us/windows/win32/api/winsvc/nf-winsvc-openscmanagerw).
	/// Originally `SC_HANDLE`.
}

impl HSC {
	/// [`CreateService`](https://learn.microsoft.com/en-us/windows/win32/api/winsvc/nf-winsvc-createservicew)
	/// function.
	#[must_use]
	pub fn CreateService(
		&self,
		service_name: &str,
		display_name: Option<&str>,
		desired_access: co::SERVICE,
		service_type: co::SERVICE_TYPE,
		start_type: co::SERVICE_START,
		error_control: co::SERVICE_ERROR,
		binary_path_name: Option<&str>,
		load_order_group: Option<&str>,
		tag_id: Option<&mut u32>,
		dependencies: &[impl AsRef<str>],
		service_start_name: Option<&str>,
		password: Option<&str>,
	) -> SysResult<CloseServiceHandleSvcGuard> {
		let binary_path_name_quoted = binary_path_name
			.map(|s| if s.starts_with('"') { s.to_owned() } else { format!("\"{}\"", s) });

		unsafe {
			PtrRet(ffi::CreateServiceW(
				self.ptr(),
				WString::from_str(service_name).as_ptr(),
				WString::from_opt_str(display_name).as_ptr(),
				desired_access.raw(),
				service_type.raw(),
				start_type.raw(),
				error_control.raw(),
				WString::from_opt_str(binary_path_name_quoted).as_ptr(),
				WString::from_opt_str(load_order_group).as_ptr(),
				tag_id.map_or(std::ptr::null_mut(), |n| n),
				WString::from_str_vec(dependencies).as_ptr(),
				WString::from_opt_str(service_start_name).as_ptr(),
				WString::from_opt_str(password).as_ptr(),
			))
			.to_sysresult_handle()
			.map(|h| CloseServiceHandleSvcGuard::new(h))
		}
	}

	/// [`OpenSCManager`](https://learn.microsoft.com/en-us/windows/win32/api/winsvc/nf-winsvc-openscmanagerw)
	/// function.
	#[must_use]
	pub fn OpenSCManager(
		machine_name: Option<&str>,
		desired_access: co::SC_MANAGER,
	) -> SysResult<CloseServiceHandleGuard> {
		unsafe {
			PtrRet(ffi::OpenSCManagerW(
				WString::from_opt_str(machine_name).as_ptr(),
				std::ptr::null(),
				desired_access.raw(),
			))
			.to_sysresult_handle()
			.map(|h| CloseServiceHandleGuard::new(h))
		}
	}

	/// [`OpenService`](https://learn.microsoft.com/en-us/windows/win32/api/winsvc/nf-winsvc-openservicew)
	/// function.
	#[must_use]
	pub fn OpenService(
		&self,
		service_name: &str,
		desired_access: co::SERVICE,
	) -> SysResult<CloseServiceHandleSvcGuard> {
		unsafe {
			PtrRet(ffi::OpenServiceW(
				self.ptr(),
				WString::from_str(service_name).as_ptr(),
				desired_access.raw(),
			))
			.to_sysresult_handle()
			.map(|h| CloseServiceHandleSvcGuard::new(h))
		}
	}
}