MutexDestroy

Destroys a mutex

Syntax
	KeyPgDeclareDeclare KeyPgSubSub MutexDestroy ( KeyPgByvalByVal id KeyPgAsAs KeyPgAnyAny KeyPgPtrPtr )

Usage
	MutexDestroy( id )

Parameters
	id
		The KeyPgAnyAny KeyPgPtrPtr handle of the mutex to be destroyed.

Description
	Mutexdestroy discards a mutex created by KeyPgMutexCreateMutexCreate.  This call should 
	be executed after any threads using the mutex are no longer in use.

	See KeyPgMutexCreateMutexCreate for more general information on mutexes.

Example
	See the examples in KeyPgMutexCreateMutexCreate and also KeyPgThreadCreateThreadCreate.

Dialect Differences
	* Threading is not allowed in the CompilerOptlang-lang qb dialect.

Platform Differences
	* The DOS version of FreeBASIC does not allow for threads, as the OS 
	  does not support them.
	* In Linux the threads are always started in the order they are 
	  created, this can't be assumed in Win32. It's an OS, not a FreeBASIC 
	  issue. 

Differences from QB
	* New to FreeBASIC

See also
	* KeyPgMutexCreateMutexCreate
	* KeyPgMutexLockMutexLock
	* KeyPgMutexUnlockMutexUnlock
	* KeyPgThreadCreateThreadCreate
	* KeyPgThreadWaitThreadWait

