IDebugClient2 ::D ispatchCallbacks, méthode (dbgeng.h)

Article
02/06/2025

La méthode DispatchCallbacks permet au moteur débogueur d’utiliser le thread actuel pour les rappels.

Syntaxe

HRESULT DispatchCallbacks(
  [in] ULONG Timeout
);

Paramètres

[in] Timeout

Spécifie le nombre de millisecondes à attendre avant que cette méthode ne retourne. Si délai d’expiration est INFINITE, cette méthode ne retourne pas tant que ExitDispatch est appelée ou qu’une erreur se produit.

Valeur de retour

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez valeurs de retour.

Retourner le code	Description
S_OK	La méthode a réussi (ExitDispatch a été utilisée).
S_FALSE	délai d’expiration millisecondes écoulés.

Remarques

Cette méthode retourne quand délai d’expiration millisecondes s’est écoulé, exitDispatch est appelé ou une erreur se produit.

Presque toutes les méthodes clientes doivent être appelées à partir du thread dans lequel le client a été créé ; objets de rappel inscrits auprès du client sont également appelés à partir de ce thread. Lorsque DispatchCallbacks est appelé le moteur peut utiliser le thread actuel pour effectuer des appels de rappel.

Les threads clients doivent appeler cette méthode chaque fois que cela est possible pour permettre aux rappels d’être appelés, sauf si le thread était le même thread utilisé pour démarrer la session du débogueur, auquel cas les rappels sont appelés lorsque WaitForEvent est appelée.

Pour plus d’informations sur les rappels, consultez rappels.