Método IDebugClient3::D ispatchCallbacks (dbgeng.h)

Artigo
02/23/2024

O método DispatchCallbacks permite que o mecanismo do depurador use o thread atual para retornos de chamada.

Sintaxe

HRESULT DispatchCallbacks(
  [in] ULONG Timeout
);

Parâmetros

[in] Timeout

Especifica quantos milissegundos esperar antes que esse método retorne. Se Timeout for INFINITE, esse método não retornará até ExitDispatch ser chamado ou ocorrer um erro.

Retornar valor

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido (ExitDispatch foi usado).
S_FALSE	Tempo limite de milissegundos decorridos.

Comentários

Esse método retorna quando milissegundos de tempo limite tiverem decorrido, ExitDispatch for chamado ou ocorrer um erro.

Quase todos os métodos de cliente devem ser chamados do thread no qual o cliente foi criado; objetos de retorno de chamada registrados com o cliente também são chamados desse thread. Quando DispatchCallbacks é chamado, o mecanismo pode usar o thread atual para fazer chamadas de retorno de chamada.

Os threads de cliente devem chamar esse método sempre que possível para permitir que os retornos de chamada sejam chamados, a menos que o thread tenha sido o mesmo thread usado para iniciar a sessão do depurador. Nesse caso, os retornos de chamada são chamados quando WaitForEvent é chamado.

Para obter mais informações sobre retornos de chamada, consulte Retornos de chamada.