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

Статья
08/07/2023

Метод 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 на этом клиенте или при удалении этого клиента.

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