ProcessHandleOperation Event

Fires when a process handle is being created or duplicated.

Syntax

public event OnProcessHandleOperationHandler OnProcessHandleOperation;

public delegate void OnProcessHandleOperationHandler(object sender, CbprocessProcessHandleOperationEventArgs e);

public class CbprocessProcessHandleOperationEventArgs : EventArgs {
  public bool Duplication { get; }
  public int ProcessId { get; }
  public int OriginatorProcessId { get; }
  public int OriginatorThreadId { get; }
  public int SourceProcessId { get; }
  public int TargetProcessId { get; }
  public int OriginalDesiredAccess { get; }
  public int DesiredAccess { get; set; }
  public int ResultCode { get; set; }
}
Public Event OnProcessHandleOperation As OnProcessHandleOperationHandler

Public Delegate Sub OnProcessHandleOperationHandler(sender As Object, e As CbprocessProcessHandleOperationEventArgs)

Public Class CbprocessProcessHandleOperationEventArgs Inherits EventArgs
  Public ReadOnly Property Duplication As Boolean
  Public ReadOnly Property ProcessId As Integer
  Public ReadOnly Property OriginatorProcessId As Integer
  Public ReadOnly Property OriginatorThreadId As Integer
  Public ReadOnly Property SourceProcessId As Integer
  Public ReadOnly Property TargetProcessId As Integer
  Public ReadOnly Property OriginalDesiredAccess As Integer
  Public Property DesiredAccess As Integer
  Public Property ResultCode As Integer
End Class

Remarks

This event fires when a process handle is being created or duplicated. The new handle allows operations to be performed on the associated process.

Applications may use this event to restrict the access rights that will be granted to the new process handle. For example, to prevent process termination, the application could remove the PROCESS_TERMINATE flag.

The Duplication parameter indicates whether a new process handle is being create (false), or an existing one is being duplicated (true).

The ProcessId parameter reflects the Id of the process whose handle is being created/duplicated.

The OriginatorProcessId parameter reflects the Id of the process that requested a handle be created/duplicated.

The OriginatorThreadId parameter reflects the Id of the thread that requested a handle be created/duplicated.

The SourceProcessId and TargetProcessId parameters reflect the Id of the process that is the source of the handle, and the Id of the process that receives the duplicated handle, respectively. (These parameters' values are only valid if Duplication is true.)

The OriginalDesiredAccess parameter reflects the access rights originally requested for the new handle.

The DesiredAccess parameter specifies the access rights that should be granted to the new handle; it will match OriginalDesiredAccess initially. Applications can remove access flags from this value, but they cannot add additional flags.

Please refer to Microsoft's OB_PRE_CREATE_HANDLE_INFORMATION structure documentation for more information about possible access flags.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason (e.g., a resource isn't available, security checks failed, etc.), set it to a non-zero value to report an appropriate error. Please refer to the Error Reporting and Handling topic for more information.

Note that the system APIs offer no way to report errors which occur during the processing of this request. Exceptional ResultCode values are therefore largely ignored.

This event is fired synchronously; please refer to the Event Types topic for more information.

 
 
Copyright (c) 2021 Callback Technologies, Inc. - All rights reserved.
CBFS Filter 2020 .NET Edition - Version 20.0 [Build 7917]