AddIgnoredProcessByName Method

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

Syntax

cbprocess.addIgnoredProcessByName(processName, includeChildren, [callback])

Callback

The 'callback' parameter specifies a function which will be called when the operation completes (or an error is encountered). If the 'callback' parameter is not specified, then the method will block and will not return until the operation completes (or an error is encountered).

The callback for this method is defined as:

function(err){ }

'err' is the error that occurred. If there was no error, then 'err' is 'null'.

'err' has 2 properties which hold detailed information:

err.code
err.message

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.