IDebugClient::GetEventCallbacks method (dbgeng.h)

Article
02/22/2024

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)