SetOutputCallbacks

The SetOutputCallbacks method registers an output callbacks object with this client.

HRESULT
  IDebugClient::SetOutputCallbacks(
    IN IDebugOutputCallbacks *  Callbacks
    );

HRESULT
  IDebugClient5::SetOutputCallbacksWide(
    IN IDebugOutputCallbacksWide *  Callbacks
    );

#ifdef UNICODE
#define SetOutputCallbacksT SetOutputCallbacksWide
#define IDebugOutputCallbacksT IDebugOutputCallbacksWide
#else
#define SetOutputCallbacksT SetOutputCallbacks
#define IDebugOutputCallbacksT IDebugOutputCallbacks
#endif

Parameters

Callbacks

Specifies the interface pointer to the output callbacks object to register with this client.

Return Value

S_OK

The method was successful.

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

Interface Version

SetOutputCallbacks is available in all versions of IDebugClient. SetOutputCallbacksWide is available in IDebugClient5 and later versions.

Comments

Each client can have at most one IDebugOutputCallbacks or IDebugOutputCallbacks object registered with it for output.

The IDebugOutputCallbacks interface extends the COM interface IUnknown. SetOutputCallbacks and SetOutputCAllbacksWide call the IUnknown::AddRef method in the object specified by Callbacks. The IUnknown::Release method of this interface will be called the next time SetOutputCallbacks or SetOutputCallbacksWide is called on this client, or when this client is deleted.

For more information about callbacks, see Callbacks.

Requirements

Headers: Defined in dbgeng.h. Include dbgeng.h.

See Also

IDebugOutputCallbacks, GetOutputCallbacks