ContinueDebugEvent-Funktion (debugapi.h)

Artikel
08/23/2023

Ermöglicht einem Debugger, einen Thread fortzusetzen, der zuvor ein Debugereignis gemeldet hat.

Syntax

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

Parameter

[in] dwProcessId

Der Prozessbezeichner des prozesses, der fortgesetzt werden soll.

[in] dwThreadId

Der Threadbezeichner des threads, der fortgesetzt werden soll. Die Kombination aus Prozessbezeichner und Threadbezeichner muss einen Thread identifizieren, der zuvor ein Debugereignis gemeldet hat.

[in] dwContinueStatus

Die Optionen zum Fortsetzen des Threads, der das Debugereignis gemeldet hat.

Wert	Bedeutung
DBG_CONTINUE 0x00010002L	Wenn der vom dwThreadId-Parameter angegebene Thread zuvor ein EXCEPTION_DEBUG_EVENT Debugereignis gemeldet hat, beendet die Funktion die gesamte Ausnahmeverarbeitung und setzt den Thread fort, und die Ausnahme wird als behandelt markiert. Bei jedem anderen Debugereignis setzt dieses Flag einfach den Thread fort.
DBG_EXCEPTION_NOT_HANDLED 0x80010001L	Wenn der von dwThreadId angegebene Thread zuvor ein EXCEPTION_DEBUG_EVENT Debugereignis gemeldet hat, setzt die Funktion die Ausnahmeverarbeitung fort. Wenn es sich um ein Ausnahmeereignis der ersten Chance handelt, wird die Such- und Dispatchlogik des strukturierten Ausnahmehandlers verwendet. Andernfalls wird der Prozess beendet. Bei jedem anderen Debugereignis setzt dieses Flag einfach den Thread fort.
DBG_REPLY_LATER 0x40010001L	Dieses Flag wird in Windows 10 Version 1507 oder höher unterstützt und bewirkt, dass dwThreadId das vorhandene Breaking Event wiedergibt, nachdem das Ziel fortgesetzt wurde. Durch Aufrufen der SuspendThread-API für dwThreadId kann ein Debugger andere Threads im Prozess fortsetzen und später zum Breaking zurückkehren.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Nur der Thread, der dwProcessId mit der CreateProcess-Funktion erstellt hat, kann ContinueDebugEvent aufrufen.

Nachdem die ContinueDebugEvent-Funktion erfolgreich war, wird der angegebene Thread fortgesetzt. Abhängig vom Debugereignis, das zuvor vom Thread gemeldet wurde, treten unterschiedliche Aktionen auf. Wenn der fortlaufende Thread zuvor ein EXIT_THREAD_DEBUG_EVENT Debugereignis gemeldet hat, schließt ContinueDebugEvent das Handle, das der Debugger für den Thread hat. Wenn der fortlaufende Thread zuvor ein EXIT_PROCESS_DEBUG_EVENT Debugereignis gemeldet hat, schließt ContinueDebugEvent die Handles, die der Debugger für den Prozess und den Thread hat.

Beispiele

Ein Beispiel finden Sie unter Schreiben der Hauptschleife des Debuggers.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	debugapi.h (windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

CreateProcess

Debuggingereignisse

Debuggingfunktionen

Share via