Metodo IDebugControl3::AddBreakpoint (dbgeng.h)

Articolo
02/25/2024

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. Questo può essere 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 selezionerà un ID inutilizzato.

[out] Bp

Riceve un puntatore dell'interfaccia al nuovo punto di interruzione.

Valore restituito

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
E_INVALIDARG	Impossibile creare il punto di interruzione con l'ID desiderato o il valore di Type non è stato riconosciuto.

Questo metodo può anche restituire altri valori di errore. Per altre informazioni, vedere Valori restituiti .

Commenti

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 sull'abilitazione del punto di interruzione, vedere Uso dei 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 removeBreakpoint viene chiamato.