Export (0) Print
Expand All

IDebugClient::DispatchCallbacks method

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

Syntax


HRESULT DispatchCallbacks(
  [in]  ULONG Timeout
);

Parameters

Timeout [in]

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 codeDescription
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

Header

Dbgeng.h (include Dbgeng.h or Winbase.h)

See also

IDebugClient
IDebugClient2
IDebugClient3
IDebugClient4
IDebugClient5
ExitDispatch
WaitForEvent
FlushCallbacks

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft