Struct ilhook::x86::Hooker

pub struct Hooker { /* fields omitted */ }

The entry struct in ilhook. Please read the main doc to view usage.

Implementations

impl Hooker

pub fn new(
    addr: usize,
    hook_type: HookType,
    thread_cb: CallbackOption,
    flags: HookFlags
) -> Self

Create a new Hooker.

Arguments

• addr - The being-hooked address.
• hook_type - The hook type and callback routine.
• thread_cb - The callbacks before and after hooking.
• flags - Hook flags

pub unsafe fn hook(self) -> Result<HookPoint, HookError>

Consumes self and execute hooking. Return the HookPoint.

Safety

Process may crash (instead of panic!) if:

1. addr is not an accessible memory address, or is not long enough.
2. addr points to an incorrect position. (At the middle of an instruction, or where after it other instructions may jump to)
3. Wrong Retn-val if hook_type is HookType::Retn. i.e. A cdecl function with non-zero retn-val, or a stdcall function with wrong retn-val.
4. Set NOT_MODIFY_MEMORY_PROTECT where it should not be set.
5. hook or unhook from 2 or more threads at the same time without HookFlags::NOT_MODIFY_MEMORY_PROTECT. Because of memory protection colliding.
6. Other unpredictable errors.