Partager via


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
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