Class ProcessExtensions

Namespace

Ecng.Interop

Assembly

Ecng.Interop.dll

Provides extension methods for the Process class to manage processor affinity, memory limits, and job behavior on Windows.

public static class ProcessExtensions

Inheritance

object

ProcessExtensions

Inherited Members

object.GetType()

object.MemberwiseClone()

object.ToString()

object.Equals(object)

object.Equals(object, object)

object.ReferenceEquals(object, object)

object.GetHashCode()

Methods

LimitByMemory(Process, long)

Limits the process memory usage by assigning it to a Windows Job Object with a specified process memory limit.

public static SafeFileHandle LimitByMemory(this Process process, long limit)

Parameters

process Process

The process to limit memory usage for.

limit long

The maximum allowed memory in bytes.

Returns

SafeFileHandle

A SafeFileHandle representing the job object that manages the memory limit.

Exceptions

ArgumentNullException

Thrown when the provided process is null.

ArgumentOutOfRangeException

Thrown when the provided limit is less than or equal to zero.

PlatformNotSupportedException

Thrown when the current operating system is not Windows.

InvalidOperationException

Thrown when setting the job object information or assigning the process to the job object fails.

SetKillChildsOnClose(Process)

Configures the process to automatically kill its child processes when the process is closed by assigning it to a Windows Job Object with the kill-on-job-close flag.

public static SafeFileHandle SetKillChildsOnClose(this Process process)

Parameters

process Process

The process whose child processes should be terminated on close.

Returns

SafeFileHandle

A SafeFileHandle representing the job object that enforces the kill-on-job-close behavior.

Exceptions

ArgumentNullException

Thrown when the provided process is null.

PlatformNotSupportedException

Thrown when the current operating system is not Windows.

InvalidOperationException

Thrown when setting the job object information or assigning the process to the job object fails.

SetProcessorAffinity(Process, long)

Sets the processor affinity for the process, allowing control over which CPU cores the process can execute on.

public static void SetProcessorAffinity(this Process process, long cpu)

Parameters

process Process

The process whose processor affinity is to be set.

cpu long

The bitmask representing the allowed CPU cores. The mask is applied to the process's current affinity.

Exceptions

ArgumentNullException

Thrown when the provided process is null.

PlatformNotSupportedException

Thrown when the current operating system is not Windows or Linux.