IDebugControl::GetInterruptTimeout method (dbgeng.h)

Article
02/22/2024

The GetInterruptTimeout method returns the number of seconds that the engine will wait when requesting a break into the debugger.

Syntax

HRESULT GetInterruptTimeout(
  [out] PULONG Seconds
);

Parameters

[out] Seconds

Receives the number of seconds that the engine will wait for the target when requesting a break into the debugger.

Return value

This method may also return error values. See Return Values for more details.

Return code	Description
S_OK	The method was successful.

Remarks

The engine requests a break into the debugger when SetInterrupt is called with DEBUG_INTERRUPT_ACTIVE. If this interrupt times out, the engine will generate a synthetic exception event. This event will be sent to event callback objects's IDebugEventCallbacks::Exception method.

Most targets do not support interrupt time-outs. Live user-mode debugging is one of the targets that does support them.

Requirements

Requirement	Value
Target Platform	Desktop
Header	dbgeng.h (include Dbgeng.h)