IDebugClient3::SetEventCallbacks-Methode (dbgeng.h)
Die SetEventCallbacks-Methode registriert ein Ereignisrückrufobjekt bei diesem Client.
Syntax
HRESULT SetEventCallbacks(
[in, optional] PDEBUG_EVENT_CALLBACKS Callbacks
);
Parameter
[in, optional] Callbacks
Gibt den Schnittstellenzeiger auf das Ereignisrückrufobjekt an, das bei diesem Client registriert werden soll.
Rückgabewert
Abhängig von der Implementierung der Methode IDebugEventCallbacks::GetInterestMask in dem von Callbacks angegebenen Objekt können andere Werte zurückgegeben werden, wie im Abschnitt Hinweise beschrieben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode war erfolgreich. |
Hinweise
Wenn der Wert von Callbacks nicht NULL ist, wird die Methode IDebugEventCallbacks::GetInterestMask aufgerufen. Wenn der Rückgabewert nicht S_OK ist, haben SetEventCallbacks und SetEventCallbacksWide keine Auswirkung und geben diesen Wert zurück.
Für jeden Client kann höchstens ein IDebugEventCallbacks - oder IDebugEventCallbacksWide-Objekt registriert sein, um Ereignisse zu empfangen.
Die IDebugEventCallbacks-Schnittstelle erweitert die COM-Schnittstelle IUnknown. Wenn SetEventCallbacks und SetEventCallbacksWide erfolgreich sind, rufen sie die IUnknown::AddRef-Methode des durch Callbacks angegebenen Objekts auf. Die IUnknown::Release-Methode dieses Objekts wird aufgerufen, wenn SetEventCallbacks oder SetEventCallbacksWide das nächste Mal auf diesem Client aufgerufen wird oder wenn dieser Client gelöscht wird.
Weitere Informationen zu Rückrufen finden Sie unter Rückrufe.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | dbgeng.h (dbgeng.h einschließen) |