IDebugEngine2
Questa interfaccia rappresenta un motore di debug (DE). Viene usato per gestire vari aspetti di una sessione di debug, dalla creazione di punti di interruzione all'impostazione e alla cancellazione delle eccezioni.
Sintassi
IDebugEngine2 : IUnknown
Note per gli implementatori
Questa interfaccia viene implementata da un de personalizzato per gestire il debug dei programmi. Questa interfaccia deve essere implementata dalla de.
Note per i chiamanti
Questa interfaccia viene chiamata dal gestore di debug della sessione (SDM) per gestire la sessione di debug, tra cui la gestione delle eccezioni, la creazione di punti di interruzione e la risposta agli eventi sincroni inviati dalla de.
Metodi nell'ordine Vtable
Nella tabella seguente vengono illustrati i metodi di IDebugEngine2.
| metodo | Descrizione |
|---|---|
| EnumPrograms | Crea un enumeratore per tutti i programmi sottoposti a debug da un de. |
| Collega | Collega un de a un programma. |
| CreatePendingBreakpoint | Crea un punto di interruzione in sospeso nella de. |
| SetException | Specifica il modo in cui l'oggetto DE deve gestire una determinata eccezione. |
| RemoveSetException | Rimuove l'eccezione specificata in modo che non venga più gestita dal motore di debug. |
| RemoveAllSetExceptions | Rimuove l'elenco di eccezioni impostate dall'IDE per un'architettura o un linguaggio di runtime specifico. |
| GetEngineID | Ottiene il GUID dell'oggetto DE. |
| DestroyProgram | Informa un DE che il programma specificato è stato terminato in modo atipico e che DE deve pulire tutti i riferimenti al programma e inviare un evento di eliminazione definitiva del programma. |
| ContinueFromSynchronousEvent | Chiamato da SDM per indicare che è stato ricevuto ed elaborato un evento di debug sincrono, precedentemente inviato dal de al SDM. |
| SetLocale | Imposta le impostazioni locali dell'oggetto DE. |
| SetRegistryRoot | Imposta la radice del Registro di sistema attualmente in uso da DE. |
| SetMetric | Imposta una metrica. |
| CauseBreak | Richiede che tutti i programmi sottoposti a debug da questa DE interrompano l'esecuzione alla successiva esecuzione di uno dei thread che tentano di eseguire. |
Requisiti
Intestazione: Msdbg.h
Spazio dei nomi: Microsoft.VisualStudio.Debugger.Interop
Assembly: Microsoft.VisualStudio.Debugger.Interop.dll