Struct VmtHook 

pub struct VmtHook { /* private fields */ }

a single VMT entry hook (modifies vtable directly)

this affects all objects of the class. use ShadowVmt for instance-specific hooking.

Implementations

impl VmtHook

pub unsafe fn new( object: *const (), index: usize, detour: usize, ) -> Result<Self>

create and install a VMT hook

Arguments

• object - pointer to the C++ object (or any pointer to a vptr)
• index - index of the virtual function in the vtable
• detour - address of the detour function

Safety

The object pointer must point to a valid C++ object with a vtable. The index must be a valid vtable index for that class.

Example

// hook the 3rd virtual function (index 2)
let hook = unsafe { VmtHook::new(object_ptr, 2, my_detour as usize)? };
let original: fn() = unsafe { std::mem::transmute(hook.original()) };

pub fn new_at_vtable(vtable: usize, index: usize, detour: usize) -> Result<Self>

create and install a VMT hook at a known vtable address

Arguments

• vtable - address of the vtable
• index - index of the virtual function
• detour - address of the detour function

pub fn install(&mut self) -> Result<()>

install the hook

pub fn uninstall(&mut self) -> Result<()>

remove the hook

pub fn is_active(&self) -> bool

check if hook is active

pub fn original(&self) -> usize

get the original function pointer

pub fn detour(&self) -> usize

get the detour function pointer

pub fn vtable_entry(&self) -> usize

get the vtable entry address

pub fn set_auto_restore(&mut self, restore: bool)

set whether to auto-restore on drop

pub fn leak(self)

leak the hook

pub fn restore(self) -> Result<()>

restore and consume

Trait Implementations

impl Drop for VmtHook

fn drop(&mut self)

Executes the destructor for this type.

impl Send for VmtHook

impl Sync for VmtHook