Suspends the specified thread.

DWORD SuspendThread(
    HANDLE hThread

DWORD RtSuspendThread(
    HANDLE hThread
);

Parameters

hThread

Handle to the thread.

Remarks

If the function succeeds, the specified thread's execution suspends and the thread's suspend count increments.

Suspending a thread causes the thread to stop executing user-mode (application) code.

ResumeThread decrements a a suspended thread's suspend count.

Return Values

The thread's previous suspend count

Success.

0xFFFFFFFF

Failure. For extended error information, see GetLastError.

Requirements

Note

• In the iwin32 API, SuspendThread and RtSuspendThread are synonyms.
• This function operates in the real-time portion of your application.

See Also

ResumeThread, iwin32 API, iwin32 Overview