IDebugClient4：：SetEventCallbacks 方法 (dbgeng.h)

项目
02/26/2024

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

语法

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

参数

[in, optional] Callbacks

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

返回值

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

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

注解

如果 Callbacks 的值不为 NULL，则调用方法 IDebugEventCallbacks：：GetInterestMask 。如果未S_OK返回值， 则 SetEventCallbacks 和 SetEventCallbacksWide 不起作用，它们返回此值。

每个客户端最多可以有一个 IDebugEventCallbacks 或 IDebugEventCallbacksWide 对象注册，用于接收事件。

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

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