IDebugControl3::SetNotifyEventHandle method (dbgeng.h)

Article
02/22/2024

The SetNotifyEventHandle method sets the event that will be signaled after the next exception in a target.

Syntax

HRESULT SetNotifyEventHandle(
  [in] ULONG64 Handle
);

Parameters

[in] Handle

Specifies the handle of the event to signal. If Handle is NULL, no event will be signaled.

Return value

This method may also return error values. See Return Values for more details.

Return code	Description
S_OK	The method was successful.

Remarks

After setting the event to signal, and after the next exception occurs in a target, when the engine resumes execution in the target, the event will be signaled.

The event will only be signaled once. After it has been signaled, GetNotifyEventHandle will return NULL, unless this method is called to set another event to signal.

Requirements

Requirement	Value
Target Platform	Desktop
Header	dbgeng.h (include Dbgeng.h)