IDebugClient5：：SetEventCallbacks 方法（dbgeng.h）

SetEventCallbacks 方法會向這個客戶端註冊事件回呼物件。

語法

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

參數

[in, optional] Callbacks

指定要向這個客戶端註冊之事件回呼物件的介面指標。

返回值

根據 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 方法。

如需回呼的詳細資訊，請參閱回呼。