ThreadHandleOperation Event

Fires when a thread handle is being created or duplicated.

Syntax

public class DefaultCbprocessEventListener implements CbprocessEventListener {
  ...
  public void threadHandleOperation(CbprocessThreadHandleOperationEvent e) {}
  ...
}

public class CbprocessThreadHandleOperationEvent {
  public boolean duplication;
  public int processId;
  public int threadId;
  public int originatorProcessId;
  public int originatorThreadId;
  public int sourceProcessId;
  public int targetProcessId;
  public int originalDesiredAccess;
  public int desiredAccess;
  public int resultCode;
}

Remarks

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

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

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

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

The ThreadId parameter reflects the Id of the thread 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.