add_filtered_process_by_id Method

Adds a process, by PID, to the list of filtered processes.

Syntax

def add_filtered_process_by_id(process_id: int, include_children: bool) -> None: ...

Remarks

This method adds the process with the specified ProcessId (PID) to the list of processes whose requests should be filtered (i.e., that the class should 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 ProcessId parameter specifies the PID of the process whose requests should be filtered. The value passed for this parameter must either be the PID of an existing process; or -1, which means "all processes". When adding a PID-based rule, you need to be aware of the PID Reuse behavior of Windows.

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

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