Función ResumeThread (processthreadsapi.h)

Artículo
03/01/2024

Disminuye el recuento de suspensiones de un subproceso. Cuando el recuento de suspensiones se reduce a cero, se reanuda la ejecución del subproceso.

Sintaxis

DWORD ResumeThread(
  [in] HANDLE hThread
);

Parámetros

[in] hThread

Identificador del subproceso que se va a reiniciar.

Este identificador debe tener el derecho de acceso THREAD_SUSPEND_RESUME. Para obtener más información, consulte Derechos de acceso y seguridad de subprocesos.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es el recuento de suspensiones anterior del subproceso.

Si se produce un error en la función, el valor devuelto es (DWORD) -1. Para obtener información de error extendida, llame a GetLastError.

Comentarios

La función ResumeThread comprueba el recuento de suspensiones del subproceso del asunto. Si el recuento de suspensiones es cero, el subproceso no se suspende actualmente. De lo contrario, se disminuye el recuento de suspensiones del subproceso del asunto. Si el valor resultante es cero, se reanuda la ejecución del subproceso del asunto.

Si el valor devuelto es cero, el subproceso especificado no se suspendió. Si el valor devuelto es 1, se suspendió el subproceso especificado, pero se reinició. Si el valor devuelto es mayor que 1, el subproceso especificado todavía se suspende.

Tenga en cuenta que, al notificar eventos de depuración, todos los subprocesos del proceso de informes se inmovilizan. Se espera que los depuradores usen las funciones SuspendThread y ResumeThread para limitar el conjunto de subprocesos que se pueden ejecutar dentro de un proceso. Al suspender todos los subprocesos de un proceso excepto para el que notifica un evento de depuración, es posible "un solo paso" un único subproceso. Las demás subprocesos no se liberan mediante una operación de continuación si se suspenden.

Windows Phone 8.1: esta función es compatible con las aplicaciones de Windows Phone Store en Windows Phone 8.1 y versiones posteriores.

Windows 8.1 y Windows Server 2012 R2: esta función es compatible con las aplicaciones de la Tienda Windows en Windows 8.1, Windows Server 2012 R2 y versiones posteriores.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	processthreadsapi.h (incluya Windows.h en Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Library	Kernel32.lib; WindowsPhoneCore.lib en Windows Phone 8.1
Archivo DLL	Kernel32.dll; KernelBase.dll en Windows Phone 8.1