Voltar à lista
Windows Win32Processos & threadskernel32.dll

SuspendThread

Incrementa o contador de suspensão de uma thread, pausando sua execução se o contador se tornar positivo.

Descrição

Não tem equivalente direto e seguro no POSIX/Linux tradicional — suspender uma thread arbitrária de fora é uma operação considerada arriscada (pode pausá-la segurando um lock), mas é uma primitiva de primeira classe no Windows, usada por depuradores.

Header: processthreadsapi.hDLL: kernel32.dllNative API: NtSuspendThread

Assinatura

DWORD SuspendThread(HANDLE hThread);

Parâmetros

ParâmetroTipoDescrição
hThreadHANDLEHandle da thread, com direito THREAD_SUSPEND_RESUME.

Valor de retorno

A contagem de suspensão anterior em sucesso; (DWORD) -1 em erro (consulte GetLastError).

Códigos de erro (GetLastError)

ERROR_ACCESS_DENIED(5)
Acesso negado.
ERROR_INVALID_HANDLE(6)
O identificador (handle) informado é inválido.

Relacionadas

Mesma categoria

CloseHandleCreateProcessWCreateRemoteThreadCreateThreadDuplicateHandleExitProcessExitThreadGetCurrentProcess