Struct HookSession 

pub struct HookSession {
    pub module: ModuleHandle,
    pub installed: Vec<InstalledHook>,
}

Fields

module: ModuleHandle

installed: Vec<InstalledHook>

Implementations

impl HookSession

pub unsafe fn unhook_all(&mut self) -> Result<()>

Examples found in repository

examples/inline_hooks_builder.rs (line 36)

fn main() -> dobby_rs_framework::Result<()> {
    // EN/CN: Keep this example tiny: install, then uninstall.

    #[cfg(unix)]
    let builder: InlineHooksBuilder<'_> = inline_hooks(common::DEMO_LIB)
        .hook_alias(
            "puts",
            "puts",
            common::detours::unix::detour_puts
                as unsafe extern "C" fn(*const core::ffi::c_char) -> core::ffi::c_int,
        )
        .extra_action_fn(|m| common::resolve_and_print(m, "puts"));
    #[cfg(unix)]
    let mut session: HookSession = unsafe { builder.install()? };

    #[cfg(windows)]
    let builder: InlineHooksBuilder<'_> = inline_hooks(common::DEMO_LIB)
        .hook_alias(
            "GetTickCount",
            "GetTickCount",
            common::detours::windows::detour_get_tick_count as unsafe extern "system" fn() -> u32,
        )
        .extra_action_fn(|m| common::resolve_and_print(m, "GetTickCount"));
    #[cfg(windows)]
    let mut session: HookSession = unsafe { builder.install()? };

    unsafe { session.unhook_all()? };
    Ok(())
}

examples/inline_hooks_config.rs (line 46)

fn main() -> dobby_rs_framework::Result<()> {
    common::init_example_logging();

    // EN: Build HookDef(s) using helpers.
    // CN: 使用 helper 构造 HookDef。
    #[cfg(unix)]
    let hooks: Vec<HookDef> = vec![make_hook(
        "puts",
        "puts_cfg",
        common::detours::unix::detour_puts
            as unsafe extern "C" fn(*const core::ffi::c_char) -> core::ffi::c_int,
    )];
    #[cfg(windows)]
    let hooks: Vec<HookDef> = vec![make_hook_simple(
        "GetCurrentProcessId",
        common::detours::windows::detour_get_current_process_id
            as unsafe extern "system" fn() -> u32,
    )];

    let mut session: HookSession = unsafe {
        install_inline_hooks(InlineHooksConfig {
            lib_name: common::DEMO_LIB,
            hooks,
            extra_action: Some(Box::new(|m: &ModuleHandle| {
                // EN: `ModuleHandle` is available here.
                // CN: 这里可以拿到 `ModuleHandle`。
                let sym = if cfg!(windows) {
                    "GetCurrentProcessId"
                } else {
                    "puts"
                };
                common::resolve_and_print(m, sym)
            })),
        })?
    };

    unsafe { session.unhook_all()? };
    Ok(())
}