Freigeben über

IDebugProgramEx2::Attach

  • Artikel

Fügen Sie eine Sitzung an ein Programm an.

Syntax

int Attach( 
   IDebugEventCallback2 pCallback,
   uint                 dwReason,
   IDebugSession2       pSession
);

Parameter

pCallback
[in] Ein IDebugEventCallback2 -Objekt, das die Rückruffunktion darstellt, an die das angefügte Debugmodul Ereignisse sendet.

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

pSession
[in] Ein Wert, der die Sitzung eindeutig identifiziert, die an das Programm angefügt ist.

Rückgabewert

Wenn die Ausführung erfolgreich ist, wird S_OK zurückgegeben, andernfalls ein Fehlercode. Diese Methode sollte zurückgegeben E_ATTACH_DEBUGGER_ALREADY_ATTACHED werden, wenn das Programm bereits angefügt ist.

Hinweise

Der Port, der das Programm enthält, kann den Wert pSession verwenden, um zu bestimmen, welche Sitzung versucht, an das Programm anzufügen. Wenn beispielsweise ein Port nur eine Debugsitzung gleichzeitig an einen Prozess anfügen kann, kann der Port ermitteln, ob die gleiche Sitzung bereits an andere Programme im Prozess angefügt ist.

Hinweis

Die übergebene pSession Schnittstelle ist nur als Cookie zu behandeln, ein Wert, der den Sitzungsdebug-Manager eindeutig identifiziert, der an dieses Programm angefügt ist. Keine der Methoden auf der bereitgestellten Schnittstelle ist funktionsfähig.

Siehe auch