Change Current Thread (QteChangeCurrentThread) API

The Change Current Thread (QteChangeCurrentThread) API changes the current thread to any thread being debugged. (1) A current thread has several properties that distinguish it from other threads being debugged:

• Debug commands are run in this thread.

• This is the first thread released after a return to the base debug support after a debug stop (breakpoint, step, watch, or unmonitored exception).

• If there are multiple debug stops at the same time, this thread is the first one processed.

Before the current thread can be changed the new current thread must be stopped or halted and is waiting for debug to restart it. If this is not true, an error is returned to the API caller and the current thread is not changed.

Threads debugging is supported if a service job is used to debug a job that was spawned by native threads support. If this is not the debug environment present when this API is called, a CPF958B error is returned.

Required Parameter Group

Thread ID

INPUT; CHAR(8)

This is an 8-byte handle assigned by the system.

Error code

I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error Code Parameter.

Error Messages

CPF3CF1 E

Error code parameter not valid.

CPF3CF2 E

Error(s) occurred during running of &1 API.

CPF9541 E

Not in debug mode.

CPF9549 E

Error addressing API parameter.

CPF9589 E

Thread &1 not stopped or halted.

CPF958A E

Thread &1 not found.

CPF958B E

Threads debugging not supported.