IDebugClient::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 werden möglicherweise andere Werte zurückgegeben, 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 beim nächsten Aufruf von SetEventCallbacks oder SetEventCallbacksWide auf diesem Client oder beim Löschen dieses Clients aufgerufen.
Weitere Informationen zu Rückrufen finden Sie unter Rückrufe.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | dbgeng.h (einschließlich Dbgeng.h) |