Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thiskai/rust-windows-dll
Macro for dynamically loading windows dll functions
https://github.com/thiskai/rust-windows-dll
Last synced: 8 days ago
JSON representation
Macro for dynamically loading windows dll functions
- Host: GitHub
- URL: https://github.com/thiskai/rust-windows-dll
- Owner: thisKai
- License: mit
- Created: 2020-04-20T15:51:36.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2023-08-12T08:29:27.000Z (over 1 year ago)
- Last Synced: 2024-03-15T14:22:23.974Z (8 months ago)
- Language: Rust
- Homepage:
- Size: 112 KB
- Stars: 21
- Watchers: 3
- Forks: 6
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# windows-dll
Macro for dynamically loading windows dll functions
## Usage
```rust
use {
windows_dll::dll,
winapi::shared::{
minwindef::ULONG,
ntdef::{NTSTATUS, NT_SUCCESS, WCHAR},
},
};
#[allow(non_snake_case)]
#[repr(C)]
struct OSVERSIONINFOW {
dwOSVersionInfoSize: ULONG,
dwMajorVersion: ULONG,
dwMinorVersion: ULONG,
dwBuildNumber: ULONG,
dwPlatformId: ULONG,
szCSDVersion: [WCHAR; 128],
}
#[dll(ntdll)]
extern "system" {
#[allow(non_snake_case)]
fn RtlGetVersion(lpVersionInformation: *mut OSVERSIONINFOW) -> NTSTATUS;
}
fn os_version_info() -> OSVERSIONINFOW {
unsafe {
let mut vi = OSVERSIONINFOW {
dwOSVersionInfoSize: 0,
dwMajorVersion: 0,
dwMinorVersion: 0,
dwBuildNumber: 0,
dwPlatformId: 0,
szCSDVersion: [0; 128],
};
let status = RtlGetVersion(&mut vi as _);
if NT_SUCCESS(status) {
vi
} else {
panic!()
}
}
}
```
### Return a result to determine whether the function can be retrieved
```rust
#[dll(ntdll)]
extern "system" {
#[allow(non_snake_case)]
#[fallible]
fn RtlGetVersion(lpVersionInformation: *mut OSVERSIONINFOW) -> NTSTATUS;
}
fn os_version_info() -> Result {
unsafe {
let mut vi = OSVERSIONINFOW {
dwOSVersionInfoSize: 0,
dwMajorVersion: 0,
dwMinorVersion: 0,
dwBuildNumber: 0,
dwPlatformId: 0,
szCSDVersion: [0; 128],
};
let status = RtlGetVersion(&mut vi as _)?;
if NT_SUCCESS(status) {
Ok(vi)
} else {
panic!()
}
}
}
```
### Give the rust wrapper a different name to the dll export
```rust
#[dll(ntdll)]
extern "system" {
#[link_name = "RtlGetVersion"]
fn rtl_get_version(lp_version_information: *mut OSVERSIONINFOW) -> NTSTATUS;
}
```
### Use a dll export without a name
```rust
#[dll(uxtheme)]
extern "system" {
#[link_ordinal = 133]
fn allow_dark_mode_for_window(hwnd: HWND, allow: BOOL) -> BOOL;
}
```
### Check whether a function exists
```rust
#[dll(ntdll)]
extern "system" {
#[link_name = "RtlGetVersion"]
fn rtl_get_version(lp_version_information: *mut OSVERSIONINFOW) -> NTSTATUS;
}
unsafe fn rtl_get_version_exists() -> bool {
rtl_get_version::exists()
}
```
### Pass flags to the underlying LoadLibraryExW call
```rust
use windows_dll::*;
#[dll(ntdll, LOAD_LIBRARY_SEARCH_SYSTEM32)]
extern "system" {
#[link_name = "RtlGetVersion"]
fn rtl_get_version(lp_version_information: *mut OSVERSIONINFOW) -> NTSTATUS;
}
```