IDebugControl::GetNotifyEventHandle method (dbgeng.h)

The GetNotifyEventHandle method receives the handle of the event that will be signaled after the next exception in a target.

Syntax

HRESULT GetNotifyEventHandle(
  [out] PULONG64 Handle
);

Parameters

[out] Handle

Receives the handle of the event that will be signaled. 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

If an event to be signaled was set and an exception occurs in a target, when the engine resumes execution in the target again, the event will be signaled.

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

Requirements

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

See also

IDebugControl

IDebugControl2

IDebugControl3

SetNotifyEventHandle