Función ContinueDebugEvent (debugapi.h)

  • Artículo

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
DBG_CONTINUE
0x00010002L
 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.
DBG_EXCEPTION_NOT_HANDLED
0x80010001L
 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.
DBG_REPLY_LATER
0x40010001L
 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

Vea también

CreateProcess

Eventos de depuración

Funciones de depuración