Метод IDebugClient5::SetEventCallbacks (dbgeng.h)
Метод SetEventCallbacks регистрирует объект обратного вызова события в этом клиенте.
Синтаксис
HRESULT SetEventCallbacks(
[in, optional] PDEBUG_EVENT_CALLBACKS Callbacks
);
Параметры
[in, optional] Callbacks
Указывает указатель интерфейса на объект обратного вызова события для регистрации в этом клиенте.
Возвращаемое значение
В зависимости от реализации метода IDebugEventCallbacks::GetInterestMask в объекте, заданном callbacks, могут возвращаться другие значения, как описано в разделе Примечания.
| Код возврата | Описание |
|---|---|
|
Метод выполнен успешно. |
Комментарии
Если значение callbacks не равно NULL, вызывается метод IDebugEventCallbacks::GetInterestMask . Если возвращаемое значение не является S_OK, setEventCallbacks и SetEventCallbacksWide не действуют и возвращают это значение.
Каждый клиент может иметь не более одного объекта IDebugEventCallbacks или IDebugEventCallbacksWide , зарегистрированного с ним для получения событий.
Интерфейс IDebugEventCallbacks расширяет интерфейс COM IUnknown. При успешном выполнении команд SetEventCallbacks и SetEventCallbacksWide они вызывают метод IUnknown::AddRef объекта, указанного функцией Callbacks. Метод IUnknown::Release этого объекта будет вызываться при следующем вызове Метода SetEventCallbacks или SetEventCallbacksWide для этого клиента или при удалении этого клиента.
Дополнительные сведения о обратных вызовах см. в разделе Обратные вызовы.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | dbgeng.h (включая Dbgeng.h) |