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

Artículo
02/23/2024

El método DispatchCallbacks permite al motor del depurador usar el subproceso actual para devoluciones de llamada.

Sintaxis

HRESULT DispatchCallbacks(
  [in] ULONG Timeout
);

Parámetros

[in] Timeout

Especifica cuántos milisegundos se deben esperar antes de que este método devuelva. Si Timeout es INFINITE, este método no devolverá hasta que se llame a ExitDispatch o se produzca un error.

Valor devuelto

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto	Descripción
S_OK	El método se realizó correctamente (se usó ExitDispatch ).
S_FALSE	Milisegundos de tiempo de espera transcurridos.

Comentarios

Este método devuelve cuando han transcurrido milisegundos de tiempo de espera, se llama a ExitDispatch o se produce un error.

Se debe llamar a casi todos los métodos de cliente desde el subproceso en el que se creó el cliente; También se llama a los objetos de devolución de llamada registrados con el cliente desde este subproceso. Cuando se llama a DispatchCallbacks , el motor puede usar el subproceso actual para realizar llamadas de devolución de llamada.

Los subprocesos de cliente deben llamar a este método siempre que sea posible para permitir llamar a las devoluciones de llamada, a menos que el subproceso fuera el mismo subproceso usado para iniciar la sesión del depurador, en cuyo caso se llama a las devoluciones de llamada cuando se llama a WaitForEvent .

Para obtener más información sobre las devoluciones de llamada, consulte Devoluciones de llamada.