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

#![allow(non_camel_case_types, non_snake_case)]

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

handle! { HINTERNETSESSION;
	/// Handle to an
	/// [Internet session](https://learn.microsoft.com/en-us/windows/win32/wininet/appendix-a-hinternet-handles).
	///
	/// Originally just a `HINTERNET`.
}

impl HINTERNETSESSION {
	/// [`HttpOpenRequest`](https://learn.microsoft.com/en-us/windows/win32/api/wininet/nf-wininet-httpopenrequestw)
	/// function.
	#[must_use]
	pub fn HttpOpenRequest(
		&self,
		verb: Option<&str>,
		object_name: &str,
		version: Option<&str>,
		referrer: Option<&str>,
		accept_types: &[impl AsRef<str>],
		flags: co::INTERNET_FLAG,
		context: Option<isize>,
	) -> SysResult<InternetCloseHandleGuard<HINTERNETREQUEST>> {
		let (_wacctys, mut pacctys) = create_wstr_ptr_vecs(accept_types);
		pacctys.push(std::ptr::null()); // last element must be a null pointer

		unsafe {
			PtrRet(ffi::HttpOpenRequestW(
				self.ptr(),
				WString::from_opt_str(verb).as_ptr(),
				WString::from_str(object_name).as_ptr(),
				WString::from_opt_str(version).as_ptr(),
				WString::from_opt_str(referrer).as_ptr(),
				vec_ptr(&pacctys) as _,
				flags.raw(),
				context.unwrap_or_default(),
			))
			.to_sysresult_handle()
			.map(|h| InternetCloseHandleGuard::new(h))
		}
	}
}