IDebugClient2::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
S_OK
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)

Weitere Informationen

GetEventCallbacks

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5

IDebugEventCallbacks