IDebugClient4::SetEventCallbacks 方法 (dbgeng.h)

SetEventCallbacks 方法向此客户端注册事件回调对象。

语法

HRESULT SetEventCallbacks(
  [in, optional] PDEBUG_EVENT_CALLBACKS Callbacks
);

参数

[in, optional] Callbacks

指定要注册到此客户端的事件回调对象的接口指针。

返回值

根据回调指定的对象中 IDebugEventCallbacks::GetInterestMask 方法的实现,可能会返回其他值,如备注部分所述。

返回代码 说明
S_OK
方法成功。

注解

如果 Callbacks 的值不为 NULL,则调用方法 IDebugEventCallbacks::GetInterestMask 。 如果未S_OK返回值, 则 SetEventCallbacksSetEventCallbacksWide 不起作用,它们返回此值。

每个客户端最多可以有一个 IDebugEventCallbacksIDebugEventCallbacksWide 对象注册,用于接收 事件

IDebugEventCallbacks 接口扩展了 COM 接口 IUnknown。 当 SetEventCallbacksSetEventCallbacksWide 成功时,它们调用由 Callbacks 指定的对象的 IUnknown::AddRef 方法。 下次在此客户端上调用 SetEventCallbacks 或 SetEventCallbacksWide 时,或删除此客户端时,将调用此对象的 IUnknown::Release 方法。

有关回调的详细信息,请参阅 回调

要求

要求
目标平台 桌面
标头 dbgeng.h (包括 Dbgeng.h)

另请参阅

GetEventCallbacks

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5

IDebugEventCallbacks