Метод IDebugClient3::D ispatchCallbacks (dbgeng.h)

Статья
02/23/2024

Метод DispatchCallbacks позволяет подсистеме отладчика использовать текущий поток для обратных вызовов.

Синтаксис

HRESULT DispatchCallbacks(
  [in] ULONG Timeout
);

Параметры

[in] Timeout

Указывает, сколько миллисекундах следует ожидать, прежде чем этот метод вернет. Если значение timeout равно INFINITE, этот метод не будет возвращать, пока не будет вызван ExitDispatch или не возникнет ошибка.

Возвращаемое значение

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .

Код возврата	Описание
S_OK	Метод выполнен успешно (использовался ExitDispatch ).
S_FALSE	Истекло время ожидания в миллисекундах.

Почти все клиентские методы должны вызываться из потока, в котором был создан клиент; Объекты обратного вызова , зарегистрированные в клиенте, также вызываются из этого потока. При вызове DispatchCallbacks подсистема может использовать текущий поток для выполнения обратных вызовов.

Клиентские потоки должны вызывать этот метод всякий раз, когда это возможно, чтобы разрешить обратные вызовы, если поток не был тем же потоком, который использовался для запуска сеанса отладчика. В этом случае обратные вызовы вызываются при вызове WaitForEvent .

Дополнительные сведения о обратных вызовах см. в разделе Обратные вызовы.

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	dbgeng.h (включая Dbgeng.h, Winbase.h)