IDebugClient3：：SetEventCallbacks 方法 (dbgeng.h)

發行項
02/23/2024

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

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