winbase.h


SuspendThread

Suspende la ejecución del hilo especificado.

Sintaxis

DWORD SuspendThread(
    HANDLE hThread  // identifica el hilo
   );

Parámetros:

hThread: identifica el hilo. El manipulador debe tener el acceso THREAD_SUSPEND_RESUME.

Valor de retorno

Si la función tiene éxito, el valor de retorno es el valor previo del contador de suspensiones. En caso contrario, es 0xFFFFFFFF. Para obtener información adicional sobre el error, llamar a GetLastError.

Observaciones

Si la función tiene éxito, la ejecución del hilo especificado se suspende y el contador de suspensiones del hilo se incrementa.

La suspensión de un hilo hace que el hilo detenga su ejecución en modo usuario.

Cada hilo posee un contador de suspensiones (con un valor máximo de MAXIMUM_SUSPEND_COUNT). Si el contador de suspensiones es mayor que cero, el hilo se suspende; en otro caso, el hilo no se suspende y se puede ejecutar. Llamar a SuspendThread hace que el contador de suspensiones del hilo especificado sea incrementado. Intentar incrementar más del máximo ese contador produce un error sin incrementarlo.