IDebugEventCallback2::Ereignis
Sendet eine Benachrichtigung von Ereignissen Debuggen.
HRESULT Event(
IDebugEngine2* pEngine,
IDebugProcess2* pProcess,
IDebugProgram2* pProgram,
IDebugThread2* pThread,
IDebugEvent2* pEvent,
REFIID riidEvent,
DWORD dwAttrib
);
int Event(
IDebugEngine2 pEngine,
IDebugProcess2 pProcess,
IDebugProgram2 pProgram,
IDebugThread2 pThread,
IDebugEvent2 pEvent,
ref Guid riidEvent,
uint dwAttrib
);
Parameter
pEngine
[in] Ein IDebugEngine2-Objekt, das das Debugmodul (DE) darstellt, das dieses Ereignis sendet. DE ist erforderlich, um diesen Parameter zu ergänzen.pProcess
[in] Ein IDebugProcess2-Objekt, das den Prozess darstellt, in dem das Ereignis aufgetreten ist. Dieser Parameter wird vom Debugbuild Manager der Sitzung (SDM) eingetragen. DE übergibt immer einen NULL-Wert für diesen Parameter.pProgram
[in] Ein IDebugProgram2-Objekt, das das Programm darstellt, in dem dieses Ereignis eintritt. Für die meisten Ereignisse ist dieser Parameter kein NULL-Wert.pThread
[in] Ein IDebugThread2-Objekt, das den Thread darstellt, in dem dieses Ereignis eintritt. Für das Beenden von Ereignissen, kann dieser Parameter kein NULL-Wert sein, wenn der Stapelrahmen für diesen Parameter abgerufen wird.pEvent
[in] Ein IDebugEvent2-Objekt, das das Debugereignis darstellt.riidEvent
[in] GUID, der identifiziert, das die Ereignisschnittstelle, die vom pEvent-Parameter abgerufen werden sollen.dwAttrib
[in] Eine Kombination von Flags aus der EVENTATTRIBUTES-Enumeration.
Rückgabewert
Bei Erfolg gibt S_OKzurück. andernfalls gibt einen Fehlercode zurück.
Hinweise
Wenn diese Methode aufgerufen wird dwAttrib der Parameter müssen übereinstimmen, wird der Wert zurückgegeben von der aufgerufenen Methode als IDebugEvent2::GetAttributes das Ereignisobjekt in den pEvent-Parameter übergeben.
Alle von Ereignissen werden asynchron gesendet, unabhängig davon, ob ein Ereignis selbst oder nicht asynchron ist. Wenn DE diese Methode aufruft, gibt der Rückgabewert nicht an, ob das Ereignis verarbeitet wurde, sondern nur, ob das Ereignis empfangen wurde. Auch bei den meisten Fällen ist das Ereignis nicht verarbeitet worden, wenn diese Methode erfolgreich beendet wird.