IDebugClient3::DispatchCallbacks method (dbgeng.h)

The DispatchCallbacks method lets the debugger engine use the current thread for callbacks.

Syntax

HRESULT DispatchCallbacks(
  [in] ULONG Timeout
);

Parameters

[in] Timeout

Specifies how many milliseconds to wait before this method will return. If Timeout is INFINITE, this method will not return until ExitDispatch is called or an error occurs.

Return value

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

Return code Description
S_OK
The method was successful (ExitDispatch was used).
S_FALSE
Timeout milliseconds elapsed.

Remarks

This method returns when Timeout milliseconds have elapsed, ExitDispatch is called, or an error occurs.

Almost all client methods must be called from the thread in which the client was created; callback objects registered with the client are also called from this thread. When DispatchCallbacks is called the engine can use the current thread to make callback calls.

Client threads should call this method whenever possible to allow the callbacks to be called, unless the thread was the same thread used to start the debugger session, in which case the callbacks are called when WaitForEvent is called.

For more information about callbacks, see Callbacks.

Requirements

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

See also

ExitDispatch

FlushCallbacks

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5

WaitForEvent