a0DisposeMutex()

Disposes a mutex.

Syntax

`a0tError`	`a0DisposeMutex(`
		`a0tMutex`	`*mutex );`

Name	rd/wr	Description
mutex	write	Mutex descriptor to dispose.

This routine disposes the structures allocated to a mutex and empties its descriptor. The mutex can no longer be used afer this call.

If an error condition occurs, it returns the error code, otherwise it returns A0ErrOk. Possible values are as follows:

Error Code	Description
`A0ErrInvMutex`	The mutex descriptor is invalid.
`A0ErrLockedMutex`	The mutex is locked by other thread.
`A0Err...`	Some error occurred.
`A0ErrOk`	Successful completion.