Método IDebugControl3::AddBreakpoint (dbgeng.h)

Artículo
02/26/2024

El método AddBreakpoint crea un nuevo punto de interrupción para el destino actual.

Sintaxis

HRESULT AddBreakpoint(
  [in]  ULONG             Type,
  [in]  ULONG             DesiredId,
  [out] PDEBUG_BREAKPOINT *Bp
);

Parámetros

[in] Type

Especifica el tipo de punto de interrupción del nuevo punto de interrupción. Puede ser uno de los siguientes valores:

Valor	Descripción
DEBUG_BREAKPOINT_CODE	punto de interrupción de software
DEBUG_BREAKPOINT_DATA	punto de interrupción del procesador

[in] DesiredId

Especifica el identificador deseado del nuevo punto de interrupción. Si es DEBUG_ANY_ID, el motor elegirá un identificador sin usar.

[out] Bp

Recibe un puntero de interfaz al nuevo punto de interrupción.

Valor devuelto

Código devuelto	Descripción
S_OK	Método realizado correctamente.
E_INVALIDARG	No se pudo crear el punto de interrupción con el identificador deseado o no se reconoció el valor de Type .

Este método también puede devolver otros valores de error. Consulte Valores devueltos para obtener más detalles.

Comentarios

Si DesiredId no está DEBUG_ANY_ID y otro punto de interrupción ya usa el identificador DesiredId, se producirá un error en estos métodos.

Los puntos de interrupción se crean vacíos y deshabilitados. Consulte Uso de puntos de interrupción para obtener más información sobre cómo configurar y habilitar el punto de interrupción.

El cliente se guarda como el agregador del nuevo punto de interrupción. Consulte GetAdder.

Nota Aunque IDebugBreakpoint extiende la interfaz COM IUnknown, la duración del punto de interrupción no se controla mediante la interfaz IUnknown . En su lugar, el punto de interrupción se elimina después de llamar a RemoveBreakpoint .