Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die SetEventCallbacks-Methode registriert ein Ereignisrückrufobjekt mit diesem Client.
Syntax
HRESULT SetEventCallbacks(
[in, optional] PDEBUG_EVENT_CALLBACKS Callbacks
);
Die Parameter
[in, optional] Callbacks
Gibt den Schnittstellenzeiger auf das Ereignisrückrufobjekt an, das bei diesem Client registriert werden soll.
Rückgabewert
Je nach Implementierung der Methode IDebugEventCallbacks::GetInterestMask im durch Callbacks angegebenen Objekt können andere Werte zurückgegeben werden, wie im Abschnitt "Hinweise" beschrieben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode war erfolgreich. |
Bemerkungen
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.
Jeder Client kann höchstens ein IDebugEventCallbacks oder IDebugEventCallbacksWide--Objekt für den Empfang Ereignisseregistriert haben.
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 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 | Arbeitsfläche |
| Kopfzeile | dbgeng.h (include Dbgeng.h) |