add_ignored_process_by_name Method

Adds a process, by name, to the list of ignored processes.

Syntax

def add_ignored_process_by_name(process_name: str, include_children: bool) -> None: ...

Remarks

This method adds the process with the specified ProcessName to the list of processes whose requests should be ignored (i.e., that the class should not fire events for).

This method is provided for compatibility with CBFS Registry 2017. It is recommended to use the new add_filter_rule, delete_filter_rule, and related methods instead.

The ProcessName parameter must be a valid process executable name. It may optionally begin with a path, and both the name and the path (if present) may include wildcards (* and ?). A process with a matching executable name does not actually need to exist when this method is called.

The IncludeChildren parameter specifies whether requests made by the specified process's children should also be ignored.

Note that the class's system driver ignores all processes' requests by default; applications should only use this method to explicitly exclude a process that would otherwise be filtered due to a process filtering rule added with add_filtered_process_by_id or add_filtered_process_by_name.

Note: This method can only be called when active is True.