ProcessHandleOperation Event

Fires when a process handle is being created or duplicated.

Syntax

// CBProcessProcessHandleOperationEventArgs carries the CBProcess ProcessHandleOperation event's parameters.
type CBProcessProcessHandleOperationEventArgs struct {...}

func (args *CBProcessProcessHandleOperationEventArgs) Duplication() bool
func (args *CBProcessProcessHandleOperationEventArgs) ProcessId() int32
func (args *CBProcessProcessHandleOperationEventArgs) OriginatorProcessId() int32
func (args *CBProcessProcessHandleOperationEventArgs) OriginatorThreadId() int32
func (args *CBProcessProcessHandleOperationEventArgs) SourceProcessId() int32
func (args *CBProcessProcessHandleOperationEventArgs) TargetProcessId() int32
func (args *CBProcessProcessHandleOperationEventArgs) OriginalDesiredAccess() int32
func (args *CBProcessProcessHandleOperationEventArgs) DesiredAccess() int32
func (args *CBProcessProcessHandleOperationEventArgs) SetDesiredAccess(value int32)
func (args *CBProcessProcessHandleOperationEventArgs) ResultCode() int32
func (args *CBProcessProcessHandleOperationEventArgs) SetResultCode(value int32)

// CBProcessProcessHandleOperationEvent defines the signature of the CBProcess ProcessHandleOperation event's handler function.
type CBProcessProcessHandleOperationEvent func(sender *CBProcess, args *CBProcessProcessHandleOperationEventArgs)

func (obj *CBProcess) GetOnProcessHandleOperationHandler() CBProcessProcessHandleOperationEvent
func (obj *CBProcess) SetOnProcessHandleOperationHandler(handlerFunc CBProcessProcessHandleOperationEvent)

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