minhook 0.5.0

A Rust wrapper for MinHook, a minimalistic x86/x64 API hooking library for Windows.
docs.rs failed to build minhook-0.5.0
Please check the build logs for more information.
See Builds for ideas on how to fix a failed build, or Metadata for how to configure docs.rs builds.
If you believe this is docs.rs' fault, open an issue.

minhook

Rust Crates.io rustdoc

A Rust wrapper for the MinHook library.

Unlike other detouring crates, this crate does not require nightly.

Usage

Add this to your Cargo.toml:

[dependencies]
minhook = "0.5.0"

Example

This example shows how to create a hook for a function, and also call the original function.

use minhook::{MinHook, MH_STATUS};

fn main() -> Result<(), MH_STATUS> {
    // Create a hook for the return_0 function, detouring it to return_1
    let return_0_addr = unsafe { MinHook::create_hook(return_0 as _, return_1 as _)? };

    // Enable the hook
    unsafe { MinHook::enable_all_hooks()? };

    // Call the detoured return_0 function, it should return 1
    assert_eq!(return_0(), 1);

    // Transmute the original return_0 function address to a function pointer
    let return_0_orig = unsafe { std::mem::transmute::<_, fn() -> i32>(return_0_addr) };

    // Call the original return_0 function
    assert_eq!(return_0_orig(), 0);

    Ok(())
}

fn return_0() -> i32 {
    0
}

fn return_1() -> i32 {
    1
}

License

This project is licensed under the MIT license (LICENSE or http://opensource.org/licenses/MIT).

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the MIT license, shall be licensed as above, without any additional terms or conditions.