IDebugProgramEx2::Anfügen
Fügen Sie eine Sitzung mit einem Programm an.
HRESULT Attach(
IDebugEventCallback2* pCallback,
DWORD dwReason,
IDebugSession2* pSession
);
[C#]
int Attach(
IDebugEventCallback2 pCallback,
uint dwReason,
IDebugSession2 pSession
);
Parameter
pCallback
[in] Ein IDebugEventCallback2-Objekt, das die Rückruffunktion zeigt, dass das Debugmodul für angefügte Ereignisse sendet.dwReason
[in] Ein Wert aus der ATTACH_REASON-Enumeration, der den Grund für den Anfügevorgang zu beschreiben.pSession
[in] Ein Wert, der die Sitzung eindeutig identifiziert wird, die dem Programm angefügt werden.
Rückgabewert
Bei Erfolg gibt S_OKzurück. Andernfalls wird ein Fehlercode zurückgegeben. Diese Methode sollte E_ATTACH_DEBUGGER_ALREADY_ATTACHED zurückgeben, wenn das Programm bereits angefügt ist.
Hinweise
Der Anschluss, der das Programm enthält, kann der Wert in pSession verwenden, um zu bestimmen, welche Sitzung versucht, auf das Programm anzufügen. Wenn beispielsweise ein Port nur eine Debugsitzung zur Anfügen an einen Prozess auf einmal zulässt, kann der Anschluss bestimmen, ob die gleiche Sitzung bereits in anderen Programmen im Prozess angefügt wird.
Hinweis
Die Schnittstelle, die in pSession übergeben wird, soll nur als Cookie behandelt werden, ein Wert, der den Debug- Manager der Sitzung eindeutig identifiziert, der an diesem Programm angefügt wird. Keine Methoden für die angegebene Schnittstelle sind aktiviert.