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

Статья
02/23/2024

Метод SetEventCallbacks регистрирует объект обратного вызова события в этом клиенте.

Синтаксис

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

Параметры

[in, optional] Callbacks

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

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

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

Код возврата	Описание
S_OK	Метод выполнен успешно.

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

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

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

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