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.