Share via

ContinueDebugEvent (Compact 2013)

  • Article

3/28/2014

This function unblocks the debuggee thread identified by the given thread identifier.

Syntax

BOOL ContinueDebugEvent(
  DWORD dwProcessId,
  DWORD dwThreadId,
  DWORD dwContinueStatus
);

Parameters

  • dwProcessId
    [in] A handle to the process to continue.

  • dwThreadId
    [in] Specifies the thread identifier of the thread to continue.

    The combination of process identifier and thread identifier must identify a thread that has previously reported a debugging event.

  • dwContinueStatus
    [in] 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 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 continues the thread.

Return Value

Nonzero indicates success.

Zero indicates failure.

To get extended error information, call GetLastError.

Remarks

Only the thread that created dwProcessId with the CreateProcess function can call ContinueDebugEvent.

After ContinueDebugEvent 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.

This call translates to writing the continue status as an event data and setting the debuggee event within the target thread identified by dwThreadId.

Requirements

Header

winbase.h

Library

coredll.lib

See Also

Reference

Debugging Functions
CreateProcess