Share via

IDebugProgramNode2::Attach_V7

  • Artikel

Hinweis

VERALTET. NICHT VERWENDEN.

Syntax

int Attach_V7 (
   IDebugProgram2       pMDMProgram,
   IDebugEventCallback2 pCallback,
   uint                 dwReason
);

Parameter

pMDMProgram
[in] Die IDebugProgram2-Schnittstelle , die das programm anzufügende Programm darstellt.

pCallback
[in] Die IDebugEventCallback2-Schnittstelle , die zum Senden von Debugereignissen an das SDM verwendet werden soll.

dwReason
[in] Ein Wert aus der ATTACH_REASON-Aufzählung , der den Grund für das Anfügen angibt.

Rückgabewert

Eine Implementierung sollte immer zurückgegeben werden E_NOTIMPL.

Hinweise

Warnung

Ab Visual Studio 2005 wird diese Methode nicht mehr verwendet und sollte immer zurückgegeben werden E_NOTIMPL. Sehen Sie sich die IDebugProgramNodeAttach2-Schnittstelle für einen alternativen Ansatz an, wenn der Programmknoten angeben muss, dass er nicht angefügt werden kann oder wenn der Programmknoten einfach das Programm GUIDfestlegt. Implementieren Sie andernfalls die Attach-Methode .

Vor Visual Studio 2005

Diese Methode muss nur implementiert werden, wenn die DE im Adressraum des zu debuggenden Programms ausgeführt wird. Andernfalls sollte diese Methode zurückgegeben werden S_FALSE.

Wenn diese Methode aufgerufen wird, muss die DE das Ereignisobjekt "IDebugEngineCreateEvent2 " senden, sofern sie noch nicht für diese Instanz der IDebugEngine2-Schnittstelle sowie die Ereignisobjekte "IDebugProgramCreateEvent2 " und "IDebugLoadCompleteEvent2 " gesendet wurde. Das IDebugEntryPointEvent2-Ereignisobjekt wird dann gesendet, wenn der dwReason Parameter lautet ATTACH_REASON_LAUNCH.

Die DE muss die GetProgramId-Methode für das vom IDebugProgram2-Ereignisobjekt bereitgestellte IDebugProgramCreateEvent2-Ereignisobjekt aufrufen und die GUID dieses Programms in den Instanzdaten für das IDebugProgram2 von der DE implementierte Objekt speichern.

Siehe auch