Funzione ContinueDebugEvent (debugapi.h)

  • Articolo

Consente a un debugger di continuare un thread che in precedenza ha segnalato un evento di debug.

Sintassi

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

Parametri

[in] dwProcessId

Identificatore del processo da continuare.

[in] dwThreadId

Identificatore del thread da continuare. La combinazione di identificatore di processo e identificatore del thread deve identificare un thread che ha precedentemente segnalato un evento di debug.

[in] dwContinueStatus

Opzioni per continuare il thread che ha segnalato l'evento di debug.

Valore Significato
DBG_CONTINUE
0x00010002L
 Se il thread specificato dal parametro dwThreadId ha segnalato in precedenza un evento di debug EXCEPTION_DEBUG_EVENT, la funzione arresta l'elaborazione di tutte le eccezioni e continua il thread e l'eccezione viene contrassegnata come gestita. Per qualsiasi altro evento di debug, questo flag continua semplicemente il thread.
DBG_EXCEPTION_NOT_HANDLED
0x80010001L
 Se il thread specificato da dwThreadId in precedenza ha segnalato un evento di debug EXCEPTION_DEBUG_EVENT, la funzione continua l'elaborazione delle eccezioni. Se si tratta di un evento di eccezione first-chance, viene usata la logica di ricerca e di invio del gestore eccezioni strutturato; in caso contrario, il processo viene terminato. Per qualsiasi altro evento di debug, questo flag continua semplicemente il thread.
DBG_REPLY_LATER
0x40010001L
 Supportato in Windows 10 versione 1507 o successiva, questo flag causa la riproduzione dell'evento di interruzione esistente dopo che la destinazione continua. Chiamando l'API SuspendThread su dwThreadId, un debugger può riprendere altri thread nel processo e tornare successivamente all'interruzione.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Solo il thread che ha creato dwProcessId con la funzione CreateProcess può chiamare ContinueDebugEvent.

Dopo che la funzione ContinueDebugEvent ha esito positivo, il thread specificato continua. A seconda dell'evento di debug segnalato in precedenza dal thread, si verificano azioni diverse. Se il thread continuato ha segnalato in precedenza un evento di debug EXIT_THREAD_DEBUG_EVENT, ContinueDebugEvent chiude l'handle del debugger al thread. Se il thread continuato ha segnalato in precedenza un evento di debug EXIT_PROCESS_DEBUG_EVENT, ContinueDebugEvent chiude gli handle del debugger al processo e al thread.

Esempio

Per un esempio, vedere Scrittura del ciclo principale del debugger.

Requisiti

   
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione debugapi.h (include Windows.h)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

CreateProcess

Eventi di debug

Funzioni di debug