Função ResumeThread (processthreadsapi.h)

Diminui a contagem de suspensão de um thread. Quando a contagem de suspensão é decrementada para zero, a execução do thread é retomada.

Sintaxe

DWORD ResumeThread(
  [in] HANDLE hThread
);

Parâmetros

[in] hThread

Um identificador para o thread a ser reiniciado.

Esse identificador deve ter o direito de acesso THREAD_SUSPEND_RESUME. Para obter mais informações, consulte Segurança de thread e direitos de acesso.

Retornar valor

Se a função for bem-sucedida, o valor retornado será a contagem de suspensão anterior do thread.

Se a função falhar, o valor retornado será (DWORD) -1. Para obter informações de erro estendidas, chame GetLastError.

Comentários

A função ResumeThread verifica a contagem de suspensão do thread do assunto. Se a contagem de suspensão for zero, o thread não será suspenso no momento. Caso contrário, a contagem de suspensão do thread do assunto será decrementada. Se o valor resultante for zero, a execução do thread de assunto será retomada.

Se o valor retornado for zero, o thread especificado não foi suspenso. Se o valor retornado for 1, o thread especificado foi suspenso, mas foi reiniciado. Se o valor retornado for maior que 1, o thread especificado ainda será suspenso.

Observe que, ao relatar eventos de depuração, todos os threads dentro do processo de relatório são congelados. Espera-se que os depuradores usem as funções SuspendThread e ResumeThread para limitar o conjunto de threads que podem ser executados em um processo. Ao suspender todos os threads em um processo, exceto aquele que relata um evento de depuração, é possível "uma única etapa" de um único thread. Os outros threads não serão liberados por uma operação de continuação se forem suspensos.

Windows Phone 8.1: essa função tem suporte para aplicativos da Windows Phone Store no Windows Phone 8.1 e posterior.

Windows 8.1 e Windows Server 2012 R2: essa função tem suporte para aplicativos da Windows Store em Windows 8.1, Windows Server 2012 R2 e posteriores.

Requisitos

Confira também

OpenThread

Funções de thread e processo

SuspendThread

Suspendendo a execução do thread

Threads