DebugBreakProcess function (winbase.h)

Article
02/22/2024

Causes a breakpoint exception to occur in the specified process. This allows the calling thread to signal the debugger to handle the exception.

Syntax

BOOL DebugBreakProcess(
  [in] HANDLE Process
);

Parameters

[in] Process

A handle to the process.

Return value

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

If the process is not being debugged, the function uses the search logic of a standard exception handler. In most cases, this causes the process to terminate because of an unhandled breakpoint exception.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	winbase.h (include Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll