on_thread_creation Event
Fires when a thread is being created.
Syntax
class CBProcessThreadCreationEventParams(object): @property def process_id() -> int: ... @property def thread_id() -> int: ... @property def creating_process_id() -> int: ... @property def creating_thread_id() -> int: ... @property def result_code() -> int: ... @result_code.setter def result_code(value) -> None: ... # In class CBProcess: @property def on_thread_creation() -> Callable[[CBProcessThreadCreationEventParams], None]: ... @on_thread_creation.setter def on_thread_creation(event_hook: Callable[[CBProcessThreadCreationEventParams], None]) -> None: ...
Remarks
This event fires when a thread is being created, before it is started.
Applications cannot cancel thread creation; any errors returned during this event are ignored.
The ProcessId parameter reflects the Id of the process to which the new thread belongs.
The ThreadId parameter reflects the Id of the new thread.
The CreatingProcessId parameter reflects the Id of the process that created the new thread.
The CreatingThreadId parameter reflects the Id of the thread that created the new thread.
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.