Fonction ContinueDebugEvent (debugapi.h)

Article
08/23/2023

Permet à un débogueur de continuer un thread qui a précédemment signalé un événement de débogage.

Syntaxe

BOOL ContinueDebugEvent(
  [in] DWORD dwProcessId,
  [in] DWORD dwThreadId,
  [in] DWORD dwContinueStatus
);

Paramètres

[in] dwProcessId

Identificateur de processus du processus à poursuivre.

[in] dwThreadId

Identificateur de thread du thread à continuer. La combinaison de l’identificateur de processus et de l’identificateur de thread doit identifier un thread qui a précédemment signalé un événement de débogage.

[in] dwContinueStatus

Options permettant de continuer le thread qui a signalé l’événement de débogage.

Valeur	Signification
DBG_CONTINUE 0x00010002L	Si le thread spécifié par le paramètre dwThreadId a précédemment signalé un événement de débogage EXCEPTION_DEBUG_EVENT, la fonction arrête tout traitement d’exception et continue le thread et l’exception est marquée comme gérée. Pour tout autre événement de débogage, cet indicateur continue simplement le thread.
DBG_EXCEPTION_NOT_HANDLED 0x80010001L	Si le thread spécifié par dwThreadId a précédemment signalé un événement de débogage EXCEPTION_DEBUG_EVENT, la fonction continue le traitement des exceptions. S’il s’agit d’un événement d’exception de première chance, la logique de recherche et de distribution du gestionnaire d’exceptions structuré est utilisée ; dans le cas contraire, le processus est terminé. Pour tout autre événement de débogage, cet indicateur continue simplement le thread.
DBG_REPLY_LATER 0x40010001L	Pris en charge dans Windows 10 version 1507 ou ultérieure, cet indicateur permet à dwThreadId de relire l’événement de rupture existant une fois que la cible continue. En appelant l’API SuspendThread sur dwThreadId, un débogueur peut reprendre d’autres threads dans le processus et revenir ultérieurement à la rupture.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Notes

Seul le thread qui a créé dwProcessId avec la fonction CreateProcess peut appeler ContinueDebugEvent.

Une fois la fonction ContinueDebugEvent réussie, le thread spécifié continue. Selon l’événement de débogage précédemment signalé par le thread, différentes actions se produisent. Si le thread continu a précédemment signalé un événement de débogage EXIT_THREAD_DEBUG_EVENT, ContinueDebugEvent ferme le handle que le débogueur a sur le thread. Si le thread continu a précédemment signalé un événement de débogage EXIT_PROCESS_DEBUG_EVENT, ContinueDebugEvent ferme les handles du débogueur au processus et au thread.

Exemples

Pour obtenir un exemple, consultez Écriture de la boucle principale du débogueur.

Spécifications


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	debugapi.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

CreateProcess

Événements de débogage

Fonctions de débogage

Share via