IDebugClient4::GetEventCallbacks method (dbgeng.h)

The GetEventCallbacks method returns the event callbacks object registered with this client.

Syntax

HRESULT GetEventCallbacks(
  [out] PDEBUG_EVENT_CALLBACKS *Callbacks
);

Parameters

[out] Callbacks

Receives an interface pointer to the event callbacks object registered with this client.

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

Each client can have at most one IDebugEventCallbacks or IDebugEventCallbacksWide object registered with it for receiving events.

If no event callbacks object is registered with the client, the value of Callbacks will be set to NULL.

The IDebugEventCallbacks interface extends the COM interface IUnknown. Before returning the IDebugEventCallbacks object specified by Callbacks, the engine calls its IUnknown::AddRef method. When this object is no longer needed, its IUnknown::Release method should be called.

For more information about callbacks, see Callbacks.

Requirements

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

See also

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5

IDebugEventCallbacks

SetEventCallbacks