TutRwMutexDestroy

TutRwMutexDestroy — destroy a multiple-reader/single-writer mutex

T_BOOL TutRwMutexDestroy(rw_mutex) 
T_RW_MUTEX rw_mutex;

rw_mutex — R/W mutex object to destroy

TRUE if R/W mutex object was successfully destroyed, FALSE otherwise.

If TutRwMutexDestroy fails, it returns FALSE and sets the global SmartSockets error number to one of:

T_ERR_OS — an operating system error has occurred. Call the function TutErrNumGetOs to obtain the related OS-specific error value.

T_ERR_TYPE_MISMATCH — the platform does not support threads.

T_ERR_VAL_INVALID — rw_mutex was not a valid R/W mutex object.

TutRwMutexDestroy destroys a R/W mutex object. All operating system resources associated with the R/W mutex are released.

Destroying a R/W mutex that other threads have locked or are waiting to lock has undefined results.

This example destroys a R/W mutex:

T_RW_MUTEX rw_mutex; 
. 
. 
. 
if (!TutRwMutexDestroy(rw_mutex)) { 
  /* error */ 
}