Función ContinueDebugEvent (debugapi.h)
Permite a un depurador continuar un subproceso que informó previamente de un evento de depuración.
Sintaxis
BOOL ContinueDebugEvent(
[in] DWORD dwProcessId,
[in] DWORD dwThreadId,
[in] DWORD dwContinueStatus
);
Parámetros
[in] dwProcessId
Identificador de proceso del proceso que se va a continuar.
[in] dwThreadId
Identificador de subproceso del subproceso que se va a continuar. La combinación de identificador de proceso e identificador de subproceso debe identificar un subproceso que ha notificado previamente un evento de depuración.
[in] dwContinueStatus
Las opciones para continuar con el subproceso que informó del evento de depuración.
| Valor | Significado |
|---|---|
|
Si el subproceso especificado por el parámetro dwThreadId informó previamente de un evento de depuración EXCEPTION_DEBUG_EVENT, la función detiene todo el procesamiento de excepciones y continúa el subproceso y la excepción se marca como controlada. Para cualquier otro evento de depuración, esta marca simplemente continúa el subproceso. |
|
Si el subproceso especificado por dwThreadId informó previamente de un evento de depuración EXCEPTION_DEBUG_EVENT, la función continúa el procesamiento de excepciones. Si se trata de un evento de excepción de primera oportunidad, se usa la lógica de búsqueda y distribución del controlador de excepciones estructurado; de lo contrario, se termina el proceso. Para cualquier otro evento de depuración, esta marca simplemente continúa el subproceso. |
|
Compatible con Windows 10, versión 1507 o posterior, esta marca hace que dwThreadId reproduzca el evento de interrupción existente después de que el destino continúe. Al llamar a la API SuspendThread en dwThreadId, un depurador puede reanudar otros subprocesos del proceso y, posteriormente, volver a la interrupción. |
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.
Comentarios
Solo el subproceso que creó dwProcessId con la función CreateProcess puede llamar a ContinueDebugEvent.
Una vez que la función ContinueDebugEvent se realiza correctamente, el subproceso especificado continúa. Dependiendo del evento de depuración notificado previamente por el subproceso, se producen diferentes acciones. Si el subproceso continuado informó anteriormente de un evento de depuración EXIT_THREAD_DEBUG_EVENT, ContinueDebugEvent cierra el identificador que tiene el depurador en el subproceso. Si el subproceso continuado informó anteriormente de un evento de depuración EXIT_PROCESS_DEBUG_EVENT, ContinueDebugEvent cierra los identificadores que tiene el depurador en el proceso y en el subproceso.
Ejemplos
Para obtener un ejemplo, consulte Escritura del bucle principal del depurador.
Requisitos
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | debugapi.h (incluya Windows.h) |
| Library | Kernel32.lib |
| Archivo DLL | Kernel32.dll |