IDebugProgram2

Questa interfaccia rappresenta un programma in esecuzione in un processo.

Sintassi

IDebugProgram2 : IUnknown

Note per gli implementatori

Il motore di debug (DE) e un fornitore di porte personalizzato implementano questa interfaccia per rappresentare un programma in un processo. Il gestore di debug della sessione implementa anche questa interfaccia per fornire informazioni su Attach.

Note per i chiamanti

L'evento IDebugProgramCreateEvent2 restituisce questa interfaccia per un nuovo programma. Questa interfaccia viene usata anche come parametro per molti metodi su più interfacce.

Metodi nell'ordine Vtable

Nella tabella seguente vengono illustrati i metodi di IDebugProgram2.

metodo Descrizione
EnumThreads Enumera i thread in esecuzione in questo programma.
GetName Ottiene il nome del programma.
GetProcess Ottiene il processo in cui è in esecuzione il programma.
Terminate. Termina questo programma.
Collega Allega a questo programma.
CanDetach Determina se un motore di debug (DE) può disconnettersi dal programma.
Scollega Scollega il debugger da questo programma.
GetProgramId Ottiene un identificatore univoco globale per questo programma.
GetDebugProperty Ottiene le proprietà del programma.
Eseguire Continua l'esecuzione di questo programma da uno stato arrestato. Qualsiasi stato di esecuzione precedente viene cancellato.
Continua Continua l'esecuzione di questo programma da uno stato arrestato. Qualsiasi stato di esecuzione precedente viene mantenuto.
Step Esegue un passaggio.
CauseBreak Richiede che questo programma arresti l'esecuzione alla successiva esecuzione di uno dei thread.
GetEngineInfo Ottiene il nome e l'identificatore del motore di debug (DE) che esegue questo programma.
EnumCodeContexts Enumera i contesti di codice per una determinata posizione in un file di origine.
GetMemoryBytes Ottiene i byte di memoria per questo programma.
GetDisassemblyStream Ottiene il flusso disassembly per questo programma o parte di questo programma.
EnumModules Enumera i moduli caricati da questo programma ed è in esecuzione.
GetENCUpdate Ottiene l'aggiornamento di Modifica e continuazione (ENC) per questo programma.

Un motore di debug personalizzato non implementa questo metodo (deve sempre restituire E_NOTIMPL).
EnumCodePaths Enumera i percorsi di codice di questo programma.
WriteDump Scrive un dump in un file.

Requisiti

Intestazione: msdbg.h

Spazio dei nomi: Microsoft.VisualStudio.Debugger.Interop

Assembly: Microsoft.VisualStudio.Debugger.Interop.dll

Osservazioni:

Un programma è un contenitore di thread in esecuzione in una particolare architettura di runtime, mentre un processo è costituito da uno o più programmi.

Vedi anche