IDebugClient::SetEventCallbacks-Methode (dbgeng.h)

Artikel
02/23/2024

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
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 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.