nf-debugapi-debugbreak.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:debugapi.DebugBreak	DebugBreak function (debugapi.h)	Causes a breakpoint exception to occur in the current process. This allows the calling thread to signal the debugger to handle the exception.	DebugBreak DebugBreak function _win32_debugbreak base.debugbreak debugapi/DebugBreak	base\debugbreak.htm	Debug	1ca9d2d1-eed4-4982-8964-64b44e8be256	12/05/2018	DebugBreak, DebugBreak function, _win32_debugbreak, base.debugbreak, debugapi/DebugBreak	debugapi.h	Windows.h	Windows	Windows XP [desktop apps only]	Windows Server 2003 [desktop apps only]										Kernel32.lib	Kernel32.dll		Windows			19H1	DebugBreak debugapi/DebugBreak	c++	APIRef kbSyntax	DllExport	Kernel32.dll API-MS-Win-Core-debug-l1-1-0.dll KernelBase.dll API-MS-Win-Core-debug-l1-1-1.dll API-MS-Win-DownLevel-Kernel32-l1-1-0.dll MinKernelBase.dll API-MS-Win-Core-Debug-L1-1-2.dll	DebugBreak

DebugBreak function

-description

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

To cause a breakpoint exception in another process, use the DebugBreakProcess function.

-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 calling process to terminate because of an unhandled breakpoint exception.

Examples

For an example, see Using an Exception Handler.

-see-also

Communicating with the Debugger

DebugActiveProcess

DebugBreakProcess

Debugging Functions