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

Статья
02/06/2025

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

Синтаксис

HRESULT DispatchCallbacks(
  [in] ULONG Timeout
);

Параметры

[in] Timeout

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

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

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

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

Замечания

Этот метод возвращает, когда время ожидания миллисекундах истекло, вызывается ExitDispatch или возникает ошибка.

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

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

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