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 |
|---|---|
|
The method was successful (ExitDispatch was used). |
|
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) |