Fonction ContinueDebugEvent (debugapi.h)
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 |
|---|---|
|
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. |
|
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. |
|
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 |