DebugBreak function

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.

Syntax


void WINAPI DebugBreak(void);

Parameters

This function has no parameters.

Return value

This function does not return a value.

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.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

WinBase.h (include Windows.h)

Library

Kernel32.lib

DLL

Kernel32.dll

See also

Communicating with the Debugger
Debugging Functions
DebugActiveProcess
DebugBreakProcess

 

 

Community Additions

ADD
Show:
© 2014 Microsoft