Struct OwnedProcess 

pub struct OwnedProcess(/* private fields */);

Available on crate feature inject-dll only.

A struct representing a running process. This struct owns the underlying process handle (see also BorrowedProcess for a borrowed version).

Note

The underlying handle has the following privileges:

• PROCESS_CREATE_THREAD
• PROCESS_QUERY_INFORMATION
• PROCESS_VM_OPERATION
• PROCESS_VM_WRITE
• PROCESS_VM_READ

Implementations

impl OwnedProcess

pub fn from_pid(pid: u32) -> Result<OwnedProcess, Error>

Creates a new instance from the given pid.

pub fn all() -> Vec<OwnedProcess>

Returns a list of all currently running processes.

pub fn find_all_by_name(name: impl AsRef<str>) -> Vec<OwnedProcess>

Finds all processes whose name contains the given string.

pub fn find_first_by_name(name: impl AsRef<str>) -> Option<OwnedProcess>

Finds the first process whose name contains the given string.

pub fn from_child(child: Child) -> OwnedProcess

Creates a new instance from the given child process.

pub unsafe fn borrowed_static(&self) -> BorrowedProcess<'static>

Returns a borrowed instance of this process that lives for 'static.

Safety

• This method is unsafe as the returned instance can outlive the owned instance, thus the caller must guarantee that the owned instance outlives the returned instance.

pub fn try_clone(&self) -> Result<OwnedProcess, Error>

Creates a new owning Process instance for this process by duplicating the underlying handle.

pub fn leak(self) -> BorrowedProcess<'static>

Leaks the underlying handle and return it as a non-owning BorrowedProcess instance.

pub const fn kill_on_drop(self) -> ProcessKillGuard

Returns a ProcessKillGuard wrapping this process that will automatically kill this process when dropped.

Trait Implementations

impl AsHandle for OwnedProcess

fn as_handle(&self) -> BorrowedHandle<'_>

Borrows the handle.

impl AsRawHandle for OwnedProcess

fn as_raw_handle(&self) -> *mut c_void

Extracts the raw handle.

impl Debug for OwnedProcess

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl From<Child> for OwnedProcess

fn from(child: Child) -> OwnedProcess

Converts to this type from the input type.

impl FromRawHandle for OwnedProcess

unsafe fn from_raw_handle(handle: *mut c_void) -> OwnedProcess

Constructs a new I/O object from the specified raw handle.

impl Hash for OwnedProcess

fn hash<H>(&self, state: &mut H)

where H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl IntoRawHandle for OwnedProcess

fn into_raw_handle(self) -> *mut c_void

Consumes this object, returning the raw underlying handle.

impl PartialEq<BorrowedProcess<'_>> for OwnedProcess

fn eq(&self, other: &BorrowedProcess<'_>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq for OwnedProcess

fn eq(&self, other: &OwnedProcess) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Process for OwnedProcess

type Handle = OwnedHandle

The underlying handle type.

fn borrowed(&self) -> BorrowedProcess<'_>

Returns a borrowed instance of this process.

fn try_clone(&self) -> Result<OwnedProcess, Error>

Tries to clone this process into a new instance.

fn into_handle(self) -> <OwnedProcess as Process>::Handle

Returns the underlying process handle.

unsafe fn from_handle_unchecked( handle: <OwnedProcess as Process>::Handle, ) -> OwnedProcess

Creates a new instance from the given handle.

fn current_handle() -> <OwnedProcess as Process>::Handle

Returns the pseudo handle representing the current process.

fn find_module_by_name( &self, module_name: impl AsRef<Path>, ) -> Result<Option<ProcessModule<OwnedProcess>>, Error>

Searches the modules in this process for one with the given name. The comparison of names is case-insensitive. If the extension is omitted, the default library extension .dll is appended.

fn find_module_by_path( &self, module_path: impl AsRef<Path>, ) -> Result<Option<ProcessModule<OwnedProcess>>, Error>

Searches the modules in this process for one with the given path. The comparison of paths is case-insensitive. If the extension is omitted, the default library extension .dll is appended.

fn wait_for_module_by_name( &self, module_name: impl AsRef<Path>, timeout: Duration, ) -> Result<Option<ProcessModule<OwnedProcess>>, Error>

Searches the modules in this process for one with the given name, repeatedly until a matching module is found or the given timeout elapses. The comparison of names is case-insensitive. If the extension is omitted, the default library extension .dll is appended.

fn wait_for_module_by_path( &self, module_path: impl AsRef<Path>, timeout: Duration, ) -> Result<Option<ProcessModule<OwnedProcess>>, Error>

Searches the modules in this process for one with the given path, repeatedly until a matching module is found or the given timeout elapses. The comparison of paths is case-insensitive. If the extension is omitted, the default library extension .dll is appended.

fn raw_current_handle() -> *mut c_void

Returns the raw pseudo handle representing the current process.

fn current() -> Self

where Self: Sized,

Returns an instance representing the current process.

fn is_current(&self) -> bool

Returns whether this instance represents the current process.

fn is_alive(&self) -> bool

Returns whether this process is still alive and running.

fn pid(&self) -> Result<NonZero<u32>, Error>

Returns the id of this process.

fn runs_under_wow64(&self) -> Result<bool, Error>

Returns whether this process is running under WOW64. This is the case for 32-bit programs running on a 64-bit platform.

fn is_x64(&self) -> Result<bool, Error>

Returns whether this process is a 64-bit process.

fn is_x86(&self) -> Result<bool, Error>

Returns whether this process is a 32-bit process.

fn path(&self) -> Result<PathBuf, Error>

Returns the executable path of this process.

fn base_name(&self) -> Result<OsString, Error>

Returns the file name of the executable of this process.

fn kill(&self) -> Result<(), Error>

Terminates this process with exit code 1.

fn kill_with_exit_code(&self, exit_code: u32) -> Result<(), Error>

Terminates this process with the given exit code.

fn run_remote_thread<T>( &self, remote_fn: extern "system" fn(*mut T) -> u32, parameter: *mut T, ) -> Result<u32, Error>

Starts a new thread in this process with the given entry point and argument, and waits for it to finish, returning the exit code.

fn start_remote_thread<T>( &self, remote_fn: unsafe extern "system" fn(*mut T) -> u32, parameter: *mut T, ) -> Result<OwnedHandle, Error>

Starts a new thread in this process with the given entry point and argument and returns the thread handle.

fn modules(&self) -> Result<Vec<ProcessModule<Self>>, Error>

where Self: Sized,

Returns a snapshot of all modules currently loaded in this process.

impl TryFrom<BorrowedProcess<'_>> for OwnedProcess

type Error = Error

The type returned in the event of a conversion error.

fn try_from( process: BorrowedProcess<'_>, ) -> Result<OwnedProcess, <OwnedProcess as TryFrom<BorrowedProcess<'_>>>::Error>

Performs the conversion.

impl Eq for OwnedProcess

impl Send for OwnedProcess

impl Sync for OwnedProcess