win_mem 0.2.2

win_mem, a winapi wrapper for reading and writing to memory
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

use std::string::FromUtf16Error;

use winapi::um::handleapi::{CloseHandle, INVALID_HANDLE_VALUE};
use winapi::um::winnt::{HANDLE, WCHAR};

pub type WinResult<T> = Result<T, WinErrorKind>;

#[derive(Debug)]
pub enum WinErrorKind {
    ReadMemoryError,
    WriteMemoryError,
    FindProcessError,
    FindModuleError,
}

/// For internal use only: safe wrapper for [`CloseHandle`]
#[inline]
pub fn close_h(handle: HANDLE) {
    if !handle.is_null() && handle != INVALID_HANDLE_VALUE {
        unsafe { CloseHandle(handle); }
    }
}

pub fn remove_nil_bytes<const C_STR_SIZE: usize>(c_style_str: &[WCHAR; C_STR_SIZE]) -> Result<String, FromUtf16Error> {
    for i in 0..c_style_str.len() {
        if c_style_str[i] == 0 {
            return String::from_utf16(&c_style_str[..i]);
        }
    }
    // If loop falls thought it means all `C_STR_SIZE`
    // `WCHAR`s of the `c_style_str` were non-nil
    String::from_utf16(c_style_str)
}