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

Article
02/23/2024

La méthode DispatchCallbacks permet au moteur de 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 le délai d’expiration est INFINITE, cette méthode ne retourne pas tant que ExitDispatch n’est pas appelé ou qu’une erreur se produit.

Valeur retournée

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

Code de retour	Description
S_OK	La méthode a réussi (ExitDispatch a été utilisé).
S_FALSE	Le délai d’expiration s’est écoulé en millisecondes.

Remarques

Cette méthode retourne lorsque des millisecondes de délai d’expiration se sont écoulées, que ExitDispatch est appelé ou qu’une erreur se produit.

Presque toutes les méthodes clientes doivent être appelées à partir du thread dans lequel le client a été créé ; les 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 possible pour permettre l’appel des rappels, sauf si le thread était le même thread que celui utilisé pour démarrer la session du débogueur, auquel cas les rappels sont appelés lorsque WaitForEvent est appelé.

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