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

#![allow(non_camel_case_types, non_snake_case)]

use crate::decl::*;
use crate::guard::*;
use crate::kernel::privs::*;
use crate::user::ffi;

handle! { HICON;
	/// Handle to an
	/// [icon](https://learn.microsoft.com/en-us/windows/win32/winprog/windows-data-types#hicon).
}

impl HICON {
	/// [`CopyIcon`](https://learn.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-copyicon)
	/// function.
	#[must_use]
	pub fn CopyIcon(&self) -> SysResult<DestroyIconGuard> {
		unsafe {
			PtrRet(ffi::CopyIcon(self.ptr()))
				.to_sysresult_handle()
				.map(|h| DestroyIconGuard::new(h))
		}
	}

	/// [`GetIconInfo`](https://learn.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-geticoninfo)
	/// function.
	#[must_use]
	pub fn GetIconInfo(&self) -> SysResult<ICONINFO> {
		let mut ii = ICONINFO::default();
		BoolRet(unsafe { ffi::GetIconInfo(self.ptr(), pvoid(&mut ii)) })
			.to_sysresult()
			.map(|_| ii)
	}

	/// [`GetIconInfoEx`](https://learn.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-geticoninfoexw)
	/// function.
	pub fn GetIconInfoEx(&self, icon_info: &mut ICONINFOEX) -> SysResult<()> {
		BoolRet(unsafe { ffi::GetIconInfoExW(self.ptr(), pvoid(icon_info)) }).to_sysresult()
	}
}