IDebugClient5::GetEventCallbacks-Methode (dbgeng.h)

Artikel
02/23/2024

Die GetEventCallbacks-Methode gibt das Ereignisrückrufobjekt zurück, das bei diesem Client registriert ist.

Syntax

HRESULT GetEventCallbacks(
  [out] PDEBUG_EVENT_CALLBACKS *Callbacks
);

Parameter

[out] Callbacks

Empfängt einen Schnittstellenzeiger auf das Ereignisrückrufobjekt, das bei diesem Client registriert ist.

Rückgabewert

Diese Methode gibt möglicherweise auch Fehlerwerte zurück. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.

Hinweise

Für jeden Client kann höchstens ein IDebugEventCallbacks - oder IDebugEventCallbacksWide-Objekt registriert sein, um Ereignisse zu empfangen.

Wenn kein Ereignisrückrufobjekt beim Client registriert wird, wird der Wert von Rückrufen auf NULL festgelegt.

Die IDebugEventCallbacks-Schnittstelle erweitert die COM-Schnittstelle IUnknown. Bevor das von Callbacks angegebene IDebugEventCallbacks-Objekt zurückgegeben wird, ruft die Engine die IUnknown::AddRef-Methode auf. Wenn dieses Objekt nicht mehr benötigt wird, sollte seine IUnknown::Release-Methode aufgerufen werden.

Weitere Informationen zu Rückrufen finden Sie unter Rückrufe.