Metodo IDebugControl::AddBreakpoint (dbgeng.h)

Articolo
02/06/2025

Il metodo AddBreakpoint crea un nuovo punto di interruzione per la destinazione corrente.

Sintassi

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

Parametri

[in] Type

Specifica il tipo di punto di interruzione del nuovo punto di interruzione. Può trattarsi di uno dei valori seguenti:

Valore	Descrizione
DEBUG_BREAKPOINT_CODE	punto di interruzione software
DEBUG_BREAKPOINT_DATA	punto di interruzione del processore

[in] DesiredId

Specifica l'ID desiderato del nuovo punto di interruzione. Se è DEBUG_ANY_ID, il motore sceglierà un ID inutilizzato.

[out] Bp

Riceve un puntatore di interfaccia al nuovo punto di interruzione.

Valore restituito

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.
E_INVALIDARG	Impossibile creare il punto di interruzione con l'ID desiderato o il valore di Tipo non è stato riconosciuto.

Questo metodo può anche restituire altri valori di errore. Per altri dettagli, vedere valori restituiti.

Osservazioni

Se desiredId non è DEBUG_ANY_ID e un altro punto di interruzione usa già l'ID DesiredId, questi metodi avranno esito negativo.

I punti di interruzione vengono creati vuoti e disabilitati. Per informazioni dettagliate sulla configurazione e l'abilitazione del punto di interruzione , vedere Uso di punti di interruzione.

Il client viene salvato come adder del nuovo punto di interruzione. Vedere GetAdder.

Nota Anche se IDebugBreakpoint estende l'interfaccia COM IUnknown, la durata del punto di interruzione non viene controllata usando l'interfaccia IUnknown. Al contrario, il punto di interruzione viene eliminato dopo che viene chiamato RemoveBreakpoint.