Skip to main content

single_instance_with_options

Function single_instance_with_options 

Source
pub fn single_instance_with_options(
    options: &SingleInstanceOptions,
) -> Result<Option<InstanceGuard>>
Expand description

Attempts to acquire a named single-instance guard using SingleInstanceOptions.

This is equivalent to calling single_instance_with_scope with the configured application ID and scope.

§Errors

Returns Error::InvalidInput if the configured app_id is empty, contains only whitespace, contains NUL bytes, or contains backslashes. Returns Error::WindowsApi if CreateMutexW fails.

§Examples

let options = win_desktop_utils::SingleInstanceOptions::global(
    format!("demo-options-{}", std::process::id()),
);
let guard = win_desktop_utils::single_instance_with_options(&options)?;
assert!(guard.is_some());