Метод IDebugClient5::SetEventCallbacks (dbgeng.h)

Статья
02/06/2025

Метод SetEventCallbacks регистрирует объект обратного вызова событий с помощью этого клиента.

Синтаксис

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

Параметры

[in, optional] Callbacks

Указывает указатель интерфейса на объект обратного вызова события для регистрации в этом клиенте.

Возвращаемое значение

В зависимости от реализации метода IDebugEventCallbacks::GetInterestMask в объекте, указанном обратных вызовов, возвращаются другие значения, как описано в разделе "Примечания".

Возвращаемый код	Описание
S_OK	Метод был успешным.

Замечания

Если значение обратных вызовов не NULL, вызывается метод IDebugEventCallbacks::GetInterestMask. Если возвращаемое значение не S_OK, SetEventCallbacks и SetEventCallbacksWide не влияют и возвращают это значение.

Каждый клиент может иметь не более одного IDebugEventCallbacks или объект IDebugEventCallbacksWide зарегистрирован для получения событий .

Интерфейс IDebugEventCallbacks расширяет интерфейс COM IUnknown. Если SetEventCallbacks и SetEventCallbacksWide успешно, они вызывают метод IUnknown::AddRef объекта, указанного обратных вызовов. Метод IUnknown::Release этого объекта будет вызываться при следующем вызове SetEventCallbacks или SetEventCallbacksWide или при удалении этого клиента.

Дополнительные сведения о обратных вызовах см. в обратном вызове.