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.
Example Code
For an example, see
Using an Exception Handler.
Requirements
| Client | Requires Windows Vista, Windows XP, or Windows 2000 Professional. |
| Server | Requires Windows Server 2008, Windows Server 2003, or Windows 2000 Server. |
| Header | Declared in Winbase.h; include Windows.h. |
| Library | Use Kernel32.lib. |
| DLL | Requires Kernel32.dll. |
See Also
Communicating with the Debugger
Debugging Functions
DebugActiveProcess
DebugBreakProcess
Send comments about this topic to Microsoft
Build date: 7/1/2008