DosSuspendThread

Bindings:  C, MASM 

This call temporarily suspends execution of another thread within the 
current process until a DosResumeThread call is issued. 

 DosSuspendThread     (ThreadID) 
 

 ThreadID (TID) - input 
    Thread ID to be suspended. 

 rc (USHORT) - return 
    Return code descriptions are: 

    0         NO_ERROR 
    309       ERROR_INVALID_THREADID 
 
 Remarks 

 A thread's execution is suspended when another thread in its process 
 issues DosSuspendThread, specifying the ID of the target thread. The 
 thread may not be suspended immediately because it may have locked some 
 system resources that have to be freed first.  However, the thread is not 
 allowed to execute further application program instructions until a 
 corresponding DosResumeThread is issued. 

 DosSuspendThread permits the suspension of only one other thread within 
 the current process. If a thread needs to disable all thread switching 
 within its process so the calling thread can execute time-critical code, 
 it uses DosEnterCritSec and DosExitCritSec calls.