CBFS Filter 2020 Python Edition

Questions / Feedback?

on_process_handle_operation Event

Fires when a process handle is being created or duplicated.

Syntax

class CBProcessProcessHandleOperationEventParams(object):
  @property
  def duplication() -> bool: ...
  @property
  def process_id() -> int: ...
  @property
  def originator_process_id() -> int: ...
  @property
  def originator_thread_id() -> int: ...
  @property
  def source_process_id() -> int: ...
  @property
  def target_process_id() -> int: ...
  @property
  def original_desired_access() -> int: ...
  @property
  def desired_access() -> int: ...
  @desired_access.setter
  def desired_access(value) -> None: ...
  @property
  def result_code() -> int: ...
  @result_code.setter
  def result_code(value) -> None: ...

# In class CBProcess:
@property
def on_process_handle_operation() -> Callable[[CBProcessProcessHandleOperationEventParams], None]: ...
@on_process_handle_operation.setter
def on_process_handle_operation(event_hook: Callable[[CBProcessProcessHandleOperationEventParams], None]) -> None: ...

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 Python Edition - Version 20.0 [Build 7917]