What does Windows error code 691 (ERROR_DBG_TERMINATE_THREAD) mean?

 
Previous Next
ERROR_DBG_UNABLE_TO_PROVIDE_HANDLE ERROR_DBG_TERMINATE_PROCESS

ERROR_DBG_TERMINATE_THREAD

What ERROR_DBG_TERMINATE_THREAD means

The debugger requested termination of the thread associated with the event. In practical terms, this status belongs to debugger-directed thread termination: the debug control path ends a selected thread rather than allowing it to continue normally.

Typical causes

  • A debugger command explicitly terminated the thread
  • Automated crash triage decided the thread could not safely resume
  • A test harness intentionally exercises forced thread shutdown

How to investigate

  1. Correlate the status with debugger commands and the affected thread ID
  2. Capture the thread stack before termination if diagnostic value remains
  3. Check for locks, COM apartments, or resources owned by the terminated thread

Developer guidance

Forced thread termination can leave process-wide state inconsistent. A successful debugger command does not prove the application can continue safely.

References


Looking for a different code? Search another status or error code.