Метод IDebugControl2::SetNotifyEventHandle (dbgeng.h)

Метод SetNotifyEventHandle задает событие, которое будет показано после следующего исключения в целевом объекте.

Синтаксис

HRESULT SetNotifyEventHandle(
  [in] ULONG64 Handle
);

Параметры

[in] Handle

Указывает дескриптор события для сигнала. Если handle имеет значение NULL, событие не будет сигнализировать.

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

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .

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

Комментарии

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

Событие будет сигнализировать только один раз. После передачи сигнала GetNotifyEventHandle возвращает значение NULL, если этот метод не вызывается для задания другого события для сигнала.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть dbgeng.h (включая Dbgeng.h)

См. также раздел

IDebugControl

IDebugControl2

IDebugControl3

SetNotifyEventHandle