# OS_DestroyThread

## Syntax

      #include <nitro/os.h>

      void OS_DestroyThread( OSThread* thread );

## Arguments

thread | Ended thread

## Return Values

None.

## Description

Ends the specified thread. Then switches to another executable thread.

With `OS_DestroyThread()`, a destructor function is not called even if a thread destructor has been preset using `OS_SetThreadDestructor()`.(The destructor function is called by `OS_KillThread*()`.)

It is also possible to specify the current thread for thread. If this is done, the thread kills itself and switches to the next executable thread. Even in this case, the thread destructor is not called.

If the mutex for thread is locked, all locked mutex unlock.

Be cautious when using `OS_DestroyThread()`--it suddenly terminates the specified thread thread without any advance warning. If you are going to use this function, be sure you understand the operations of threads.

## See Also

`OS_InitThread, OS_ExitThread, OS_KillThread*, OS_SetThreadDestructor`

## Revision History

2005/07/12 Noted differences with `OS_KillThread*()`.
2004/12/27 Initial version.

CONFIDENTIAL