AddIgnoredProcessByName Method

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

Syntax

int AddIgnoredProcessByName(const QString& qsProcessName, bool bIncludeChildren);

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).

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 AddFilteredProcessById or AddFilteredProcessByName.

Note: This method can only be called when Active is true.

Error Handling

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)