What does Windows error code 697 (ERROR_DBG_COMMAND_EXCEPTION) mean?

ERROR_DBG_COMMAND_EXCEPTION

What ERROR_DBG_COMMAND_EXCEPTION means

The debugger encountered an exception while processing a debugger command or command communication request. In practical terms, this status belongs to debugger command transport: the command channel, extension engine, or debugger execution path failed while handling an instruction.

Typical causes

• A debugger extension raised an exception
• Remote command serialization or transport state became invalid
• A command accessed stale target memory or an expired debug object

How to investigate

1. Record the exact command and extension version
2. Disable third-party extensions and repeat the operation
3. Check remote transport logs and whether the target changed state during the command

Developer guidance

Separate command-processing failure from the debuggee state. The target may still be paused and recoverable even though the debugger command itself failed.

References

• Microsoft: System error codes 500–999