| UID | title | description | old-location | tech.root | ms.date | keywords | 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 | f1_keywords | topic_type | api_type | api_location | api_name | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
NF:dbgeng.IDebugControl.AddBreakpoint |
IDebugControl::AddBreakpoint (dbgeng.h) |
The AddBreakpoint method creates a new breakpoint for the current target. This method belongs to the IDebugControl interface. |
debugger\addbreakpoint.htm |
debugger |
05/03/2018 |
|
AddBreakpoint, AddBreakpoint method [Windows Debugging], AddBreakpoint method [Windows Debugging],IDebugControl interface, AddBreakpoint method [Windows Debugging],IDebugControl2 interface, AddBreakpoint method [Windows Debugging],IDebugControl3 interface, IDebugControl interface [Windows Debugging],AddBreakpoint method, IDebugControl.AddBreakpoint, IDebugControl2 interface [Windows Debugging],AddBreakpoint method, IDebugControl2::AddBreakpoint, IDebugControl3 interface [Windows Debugging],AddBreakpoint method, IDebugControl3::AddBreakpoint, IDebugControl::AddBreakpoint, IDebugControl_3d11665a-ec78-4742-8195-2798601814e9.xml, dbgeng/IDebugControl2::AddBreakpoint, dbgeng/IDebugControl3::AddBreakpoint, dbgeng/IDebugControl::AddBreakpoint, debugger.addbreakpoint |
dbgeng.h |
Dbgeng.h |
Desktop |
Windows |
|
|
|
|
|
The AddBreakpoint method creates a new breakpoint for the current target.
Specifies the breakpoint type of the new breakpoint. This can be either of the following values:
| Value | Description |
|---|---|
| DEBUG_BREAKPOINT_CODE | software breakpoint |
| DEBUG_BREAKPOINT_DATA | processor breakpoint |
Specifies the desired ID of the new breakpoint. If it is DEBUG_ANY_ID, the engine will pick an unused ID.
Receives an interface pointer to the new breakpoint.
| Return code | Description |
|---|---|
|
The method was successful. |
|
The breakpoint couldn't be created with the desired ID or the value of Type was not recognized. |
This method may also return other error values. See Return Values for more details.
If DesiredId is not DEBUG_ANY_ID and another breakpoint already uses the ID DesiredId, these methods will fail.
Breakpoints are created empty and disabled. See Using Breakpoints for details on configuring and enabling the breakpoint.
The client is saved as the adder of the new breakpoint. See GetAdder.
Note Even though IDebugBreakpoint extends the COM interface IUnknown, the lifetime of the breakpoint is not controlled using the IUnknown interface. Instead, the breakpoint is deleted after RemoveBreakpoint is called.