ContinueDebugEvent
The ContinueDebugEvent
function enables a debugger to continue a thread that previously reported a
debugging event.
BOOL ContinueDebugEvent(
|
DWORD dwProcessId, |
// process to
continue |
|
DWORD dwThreadId, |
// thread to
continue |
|
DWORD dwContinueStatus |
// continuation
status |
|
); |
|
Parameters
dwProcessId
Identifies
the process to continue.
dwThreadId
Identifies
the thread to continue. The combination of process identifier and thread
identifier must identify a thread that has previously reported a debugging
event.
dwContinueStatus
Specifies how
to continue the thread that reported the debugging event.
If the
DBG_CONTINUE flag is specified for this parameter and the thread specified by
the dwThreadId parameter previously reported an EXCEPTION_DEBUG_EVENT
debugging event, the function stops all exception processing and continues the
thread. For any other debugging event, this flag simply continues the thread.
If the
DBG_EXCEPTION_NOT_HANDLED flag is specified for this parameter and the thread
specified by dwThreadId previously reported an EXCEPTION_DEBUG_EVENT
debugging event, the function continues exception processing. If this is a
first-chance exception event, the search and dispatch logic of the structured
exception handler is used; otherwise, the process is terminated. For any other
debugging event, this flag simply continues the thread.
Return Values
If the
function succeeds, the return value is nonzero.
If the
function fails, the return value is zero. To get extended error information,
call GetLastError.
Remarks
Only the
thread that created dwProcessId with the CreateProcess function
can call ContinueDebugEvent.
After the ContinueDebugEvent
function succeeds, the specified thread continues. Depending on the debugging
event previously reported by the thread, different actions occur. If the
continued thread previously reported an EXIT_THREAD_DEBUG_EVENT debugging
event, ContinueDebugEvent closes the handle the debugger has to the
thread. If the continued thread previously reported an EXIT_PROCESS_DEBUG_EVENT
debugging event, ContinueDebugEvent closes the handles the debugger has
to the process and to the thread.
See Also